Hosted MCP (no install)
Connect Claude.ai, ChatGPT, or Claude Code to your Fokus workspace over HTTP — nothing to install, all 44 tools.
Fokus hosts the MCP server for you at https://api.getfokus.com/mcp. Point any client that speaks remote MCP (Streamable HTTP) at that URL and you get the same 44 tools — tasks, calendar, notes, buckets, objectives, unified search, and the auto-scheduler — with nothing to download and nothing running on your machine.
There are two ways to connect, depending on your client.
Connect with OAuth (recommended)
Best for Claude.ai, ChatGPT, and Claude Code. You add the URL, approve access once on a Fokus screen, and you're done — no token to copy, no CLI.
Claude.ai or ChatGPT
Open your connectors / custom-integration settings, add a new MCP server, and paste the URL:
https://api.getfokus.com/mcpThe client registers itself automatically, then a Fokus "… wants to connect to your account" screen opens. Sign in if you aren't already, review the access, and click Allow.
Claude Code
claude mcp add --transport http fokus https://api.getfokus.com/mcpThe first time it's used, Claude Code opens that same Fokus approval screen in your browser. Approve once and the connection sticks.
What “Allow” grants
The connection acts as you, in your active workspace, and can read and change tasks, notes, events, and more — exactly what you can do in the app. You can revoke it anytime (see below).
Connect with a token
Best for clients that take a static Authorization header, or for headless / automation use. You mint a long-lived token once and paste it in.
Mint a token
From the fokus-mcp CLI (installed and signed in — see the local MCP server page):
fokus-mcp token create --label "Claude Code"It prints a ready-to-paste command with the token already filled in.
Add it to your client
claude mcp add --transport http fokus https://api.getfokus.com/mcp \
--header "Authorization: Bearer <token>"List your tokens with fokus-mcp token list and remove one with fokus-mcp token revoke <id>. Unlike an interactive login, these tokens don't expire from idleness — they last until you revoke them, which makes them the right fit for always-on automations.
Hosted vs. local
| Hosted (this page) | Local server | |
|---|---|---|
| Install | Nothing | The fokus-mcp CLI |
| Best for | Claude.ai, ChatGPT, Claude Code | Claude Desktop, Cursor, offline / self-hosted |
| Auth | Approve in the browser, or a token | Interactive login on your machine |
| Runs | On Fokus's servers | On your machine (over stdio) |
Both expose the identical 44 tools and the daily_planning / weekly_review prompts — pick whichever fits your client.
Good to know
- One workspace at a time. The connection operates in your active workspace and can switch to another on request.
- Deleting is permanent. Destructive tools are annotated, so well-behaved clients confirm before they remove anything.
- Disconnect anytime. Revoke a token with
fokus-mcp token revoke <id>, or remove the connector in your client. Changing your Fokus password cuts every connection at once. - Self-hosting? Point your client at your own backend's
/mcpendpoint instead ofapi.getfokus.com.
How is this guide?