2DooD MCP

Connects your 2DooD tasks to AI apps that support MCP: Claude Desktop, Claude Code, Cursor, Codex and others. The app can list, search, add, update, complete and delete your tasks. Changes show up in the 2DooD apps on iPhone, Mac and web.

Full guide: https://melomed.io/developers/2dood

Demo mode (no account)

Want to try it first? Demo mode runs the same six tools on made-up data for a fictional student, Maya Chen, a college sophomore with chemistry exams, lab reports and an internship deadline coming up. No 2DooD account, no sign-in and no network. Dates are relative to when the server starts, so there is always something due today. Changes you make are kept in memory and reset when the server restarts.

Claude Code:

claude mcp add 2dood-demo -s user -- npx -y 2dood-mcp --demo

Claude Desktop, Cursor and other apps that use mcpServers JSON:

{
  "mcpServers": {
    "2dood-demo": { "command": "npx", "args": ["-y", "2dood-mcp", "--demo"] }
  }
}

Codex (~/.codex/config.toml):

[mcp_servers.2dood-demo]
command = "npx"
args = ["-y", "2dood-mcp", "--demo"]

Setting TWODOOD_DEMO=1 in the environment does the same as --demo. Try asking "what's overdue?" or "add CHEM 201 flashcards for tomorrow night".

Related MCP server: Task Manager

Requirements

• Node.js 20 or newer

• A 2DooD account that signs in with email and password (Apple and Google sign-in aren't supported yet)

1. Sign in once

npx -y 2dood-mcp login

This asks for your 2DooD email and password. Your password isn't stored. The session is saved to ~/.config/2dood-mcp/session.json, readable only by you, and refreshes itself.

npx -y 2dood-mcp whoami   # who the server acts as
npx -y 2dood-mcp logout   # forget the session

2. Add it to your AI app

Claude Code:

claude mcp add 2dood -s user -- npx -y 2dood-mcp

Claude Desktop (claude_desktop_config.json), Cursor (~/.cursor/mcp.json) and other apps that use mcpServers JSON:

{
  "mcpServers": {
    "2dood": { "command": "npx", "args": ["-y", "2dood-mcp"] }
  }
}

Codex (~/.codex/config.toml):

[mcp_servers.2dood]
command = "npx"
args = ["-y", "2dood-mcp"]

Restart the app after editing its config.

Tools

Privacy

The server runs on your computer and signs in as you, so it can only reach your own tasks. Task text you share with an AI app is handled under that app's privacy policy.

Develop

npm install
npm test                 # node --test, demo store, no network
npm run dev -- --demo    # run from source on the demo data

npm run build bundles dist/index.js and needs TWODOOD_SUPABASE_URL and TWODOOD_SUPABASE_ANON_KEY (the public URL and publishable key, never a secret key). Most people should use the npm package instead.

src/lib/ holds the date parsing shared with the 2DooD apps.

License

MIT. The 2DooD name is not covered by the license.