MCP · Connect

Connect AI tools to GTD Brain

GTD Brain ships a hosted MCP (Model Context Protocol) server, so Claude, ChatGPT, Claude Code, and any other MCP-capable assistant can read, add, edit, move, and archive the cards on your board — in plain language. They can never delete a card. You sign in once with the same email code you use on the web; there’s no password or API token to copy, and the connection then keeps working on its own.

In a hurry? The quick steps for every assistant are below. For the full walkthroughs — prerequisites, example prompts, and troubleshooting — see the dedicated guides: ChatGPT · Claude · Claude Code · Cursor · VS Code · Telegram · Gemini CLI.

Your connection address

Every MCP setup below uses the same address — GTD Brain’s MCP server (the Telegram bot needs none):

Connect Claude

  1. Open Claude → Settings → Connectors.
  2. Click “Add custom connector” (needs a paid Claude plan).
  3. Name it “GTD Brain” and paste the address above into “Remote MCP server URL”, then click Add.
  4. Sign in with your email code and click Allow.

Stuck, or want the details? Read the full Claude guide — prerequisites, example prompts, and troubleshooting.

Connect ChatGPT

  1. Open ChatGPT → Settings → Connectors.
  2. Click “Add custom connector” (needs a paid ChatGPT plan).
  3. Paste the address above and click Connect.
  4. Sign in with your email code and click Allow.

Stuck, or want the details? Read the full ChatGPT guide — prerequisites, example prompts, and troubleshooting.

Connect Claude Code

  1. In a terminal, run:
  2. claude mcp add --transport http gtdbrain https://mcp.gtdbrain.com/api/gtdbrain/v1/mcp
  3. A browser opens — sign in with your email code and click Allow.

Stuck, or want the details? Read the full Claude Code guide — prerequisites, example prompts, and troubleshooting.

Connect Cursor

  1. Open Cursor Settings → Tools & MCP → “New MCP Server” and paste into mcp.json:
  2. { "mcpServers": { "gtdbrain": { "url": "https://mcp.gtdbrain.com/api/gtdbrain/v1/mcp" } } }
  3. Click the server's “Needs login” — a browser opens; sign in with your email code and click Allow.

Stuck, or want the details? Read the full Cursor guide — prerequisites, example prompts, and troubleshooting.

Connect VS Code

  1. Install the GTD Brain extension (Cursor, Windsurf and VSCodium find it in their own Extensions view, via Open VSX):
  2. https://marketplace.visualstudio.com/items?itemName=minosin.gtdbrain-vscode
  3. Click the GTD Brain icon in the Activity Bar → Sign in, and enter the code we email you.
  4. Select code or a TODO and press Ctrl+Alt+G (Cmd+Alt+G on a Mac) to capture it; type free thoughts in the sidebar's capture field.

Stuck, or want the details? Read the full VS Code guide — prerequisites, example prompts, and troubleshooting.

Connect Telegram

  1. Open the GTD Brain bot in Telegram (no address to paste):
  2. https://t.me/GTDBrainBot?start=web-guide
  3. Send /start, reply with your GTD Brain email, then the 4-digit code we email you.
  4. Done — anything you send the bot lands in your Inbox; /next, /waiting, /inbox and /projects show your lists.

Stuck, or want the details? Read the full Telegram guide — prerequisites, example prompts, and troubleshooting.

Connect Gemini CLI

  1. In a terminal, install the GTD Brain extension:
  2. gemini extensions install https://github.com/minosin/gtdbrain-gemini-extension
  3. Start gemini and sign in once:
  4. /mcp auth gtdbrain
  5. A browser opens — sign in with your email code and click Allow.

Stuck, or want the details? Read the full Gemini CLI guide — prerequisites, example prompts, and troubleshooting.

What can it do?

Once connected, ask your assistant things like “what’s in my Next Actions?”, “add ‘book dentist’ to my inbox”, or “move the tax card to Waiting For”. The assistant sees the same board you do — columns, cards, notes, and contexts — and every change syncs instantly to the web, iOS, and Android apps. Cards can be archived but never deleted, so nothing is ever lost to a misfired prompt.

New to GTD Brain? Get started free — then connect your AI tools from the account menu, or straight from this page. Curious what AI changes about the method itself? Read GTD with AI: the AI GTD app.