Twos

Everywhere you are

MCP: Claude and ChatGPT

iPhoneiPadAndroidWebMacWindowsLinuxWatchUpdated 2026-09-10

The Twos MCP server lets an AI assistant read and write your things directly, with your permission and under your account.

Connect Twos to Claude (MCP server walkthrough) | Twos Watch on YouTube

Why you'd care

Chat inside Twos already answers questions about what you have written. MCP is the other direction: it puts Twos inside the assistant you already use, so you can say "add these to my grocery list" in the middle of a conversation about dinner and have it actually happen.

The useful version of this is not novelty. It is that capture stops requiring you to switch apps.

Before you start

  • An assistant that supports MCP connectors. Claude and ChatGPT both do.
  • A Twos account you are signed into in a browser, because authorizing happens there.
  • Nothing to install. The server is hosted, not something you run.

The server address

This is the URL every client asks for. Copy it as it is written, with no trailing slash.

https://writethingsdown.com/mcp

Opening that address in a browser brings you to the setup guide, which has the exact steps and config for Claude, ChatGPT, Gemini, Claude Code, Cursor, VS Code, Windsurf, Cline, and the Gemini CLI.

Connect

  1. 1

    Add the connector

    In your assistant's connector or integration settings, add a custom MCP server and paste the address above.

  2. 2

    Authorize in the browser

    You will be sent to Twos to sign in and approve. This is OAuth, so the assistant never sees your password. Leave any OAuth client ID and secret fields blank.

  3. 3

    Approve the scopes

    Read and write access to your lists and things. Approve only what you are comfortable with.

  4. 4

    Check it worked

    Ask the assistant what is on your list for today. If it answers with your real things, you are connected.

Clients that read a config file instead, like Cursor, Windsurf and Gemini CLI, want an API key rather than a sign-in. Create one in Settings Advanced API Keys and send it as an Authorization: Bearer header. The setup guide has the JSON for each of them, and the developers page carries the full API reference, generated from the live spec.

What comes across

The assistant can read your lists and things, create and update them, complete them, set reminders, search, and pull up Today.

Limits and timing

Requests are rate limited per key, which is generous for conversational use and not intended for bulk migration. If you are moving thousands of things, use an import rather than an assistant.

Disconnect

Remove the connector in your assistant. That is what ends an OAuth connection. If you connected a config-file client with an API key instead, revoke the key in Settings Advanced API Keys and it stops working immediately.

Tips

  • Start read-only if you are unsure. Ask it questions for a few days before letting it write.
  • The assistant is good at bulk capture and bad at organizing. "Add these twelve" works beautifully. "Tidy up my lists" does not.
  • If you use both Claude and ChatGPT, authorize them separately so you can revoke one without the other.

If it's not working

Authorization loops back to the sign-in page. You are not signed in to Twos in that browser. Sign in there first, then retry the connector.

The assistant says it cannot see any lists. The scopes were not granted. Remove the connector and add it again, approving read access this time.

It created a thing in the wrong place. With no list named, new things go to Today, the same as any other integration. Name the list explicitly in your request.