todo4 docsBack to home
Connect your agent

Claude

Add todo4 as a Custom Connector to let Claude create, query, and update your tasks directly from chat. Works in Claude Chat, Cowork, Code, and Desktop. Takes about 30 seconds.

Requires Claude Pro or Max.Custom Connectors aren’t available on Claude’s free tier as of April 2026.

Why the Custom Connector and not the plugin?

todo4 also ships as a Claude Code plugin, but if you’re installing it through Cowork specifically there’s a known OAuth bug (anthropics/claude-code #28695) that prevents plugin-supplied MCP servers from authenticating. The Custom Connector path below works reliably end-to-end across every Claude client.

MCP Server URL
https://todo4.io/mcp

Setup steps

  1. 1In Claude, click the Customize icon in the sidebar.
  2. 2Select Connectors.
  3. 3Click Add custom connector.
  4. 4Name it "Todo4" and paste the URL above.
  5. 5Click Add. A browser tab opens for todo4 sign-in — approve the request and you’re connected.

Test your connection

Back in Claude, try one of these:

  • “List my todo4 tasks.”
  • “Create a task to review the Q2 report by Friday, p2.”
  • “What’s on my plate this week?”

Don’t have a todo4 account yet?

Sign up takes a minute. Or OAuth will create one for you on first sign-in.

Sign up freeSign in

Troubleshooting

Tools stop working after a long conversation (Cowork only)

Cowork has a known bug (#34832) where OAuth tokens get stripped during context compaction. If todo4 stops responding, re-add the connector or start a new chat. Other Claude clients aren’t affected.

The browser OAuth tab didn’t open

Check your browser’s popup blocker for the Claude domain you’re on (claude.ai for web/Cowork, or your Desktop app). Click Add on the connector dialog again to retry.

I’d rather use Claude Code CLI

The OAuth flow works end-to-end in the CLI. See the todo4-claude-plugin README for install instructions.