Claude, Cursor & MCP clients
Run your Fokus workspace from Claude Desktop, Claude Code, Cursor, or any MCP client — 44 tools over stdio.
The Fokus MCP server turns any Model Context Protocol client into a Fokus front-end. Ask Claude what your week looks like, have Cursor file the bug you just fixed as a task, or tell your assistant to auto-schedule the day — all against your real workspace.
What you get
- 44 tools across tasks, calendar events, notes, buckets, objectives, tags, reminders, calendars, unified search, day/week agenda, and the auto-scheduler.
- Markdown in, markdown out — notes and descriptions convert to and from the Fokus editor format, so headings, checklists, tables, and code blocks render properly in the app.
- Two prompts ready to run:
daily_planningandweekly_review. - Workspace-aware, with tool annotations so good clients warn you before destructive actions.
Prefer not to install anything?
Claude.ai, ChatGPT, and Claude Code can connect over HTTP with nothing on your machine — see Hosted MCP. This page covers the local server (stdio), best for Claude Desktop, Cursor, and offline or self-hosted setups.
Install the CLI
npm install -g @fokus-app/mcp # or run it on demand with npx -y @fokus-app/mcpSign in once
fokus-mcp login # email/password
fokus-mcp whoami # verify
fokus-mcp workspace # pick the default workspaceSigned up with Google, Microsoft, or Apple?
Either set a password first (Forgot password → set one), or use the paste-the-code flow: fokus-mcp login --oauth google. Your browser opens; after signing in you land on a "Redirecting to Fokus…" page — copy the code value from the address bar and paste it into the terminal.
If the Fokus desktop app is installed it may swallow the code automatically — close it first, or just use email/password.
Add it to your client
Claude Code
claude mcp add fokus -- fokus-mcpClaude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"fokus": { "command": "fokus-mcp" }
}
}Cursor
The same entry in .cursor/mcp.json.
Anything else
Running fokus-mcp with no subcommand serves MCP over stdio — point any compliant client at that command.
Restart the client and the Fokus tools appear. Try "What's on my plate tomorrow?" or "Create a task to renew the ship insurance, high priority, due Friday."
Good to know
- The assistant works in one workspace at a time — it can list your workspaces and switch mid-conversation.
- Deleting is permanent. Tools are annotated as destructive so well-behaved clients confirm first.
- Sessions expire after ~7 idle days — run
fokus-mcp loginagain when the assistant says it's signed out. - Handy on the command line too:
fokus-mcp toolslists everything, andfokus-mcp tool <name> '<json>'invokes one directly.
How is this guide?