Todoist MCP工具

1. Add this repository as a dependency

npm install @doist/todoist-mcp

Dependencies

• MCP server using the official @modelcontextprotocol/sdk
• Todoist Typescript API client @doist/todoist-sdk

Setup Guide

The Todoist MCP server is available as a streamable HTTP service for easy integration with various AI clients:

Primary URL (Streamable HTTP): https://ai.todoist.net/mcp

Claude Desktop

1. Open Settings → Connectors → Add custom connector
2. Enter https://ai.todoist.net/mcp and complete OAuth authentication

Cursor

Create a configuration file:

• Global: ~/.cursor/mcp.json
• Project-specific: .cursor/mcp.json

{
    "mcpServers": {
        "todoist": {
            "command": "npx",
            "args": ["-y", "mcp-remote", "https://ai.todoist.net/mcp"]
        }
    }
}

Then enable the server in Cursor settings if prompted.

Claude Code (CLI)

The fastest setup is the official Todoist plugin, which wires up the MCP server for you:

/plugin marketplace add doist/todoist-mcp
/plugin install todoist@doist

OAuth runs in your browser the first time you use a Todoist tool. See Anthropic's plugin docs for more.

If you'd rather configure the MCP server manually, run:

claude mcp add --transport http todoist https://ai.todoist.net/mcp

Then launch claude, execute /mcp, and select the todoist MCP server to authenticate.

Visual Studio Code

1. Open Command Palette → MCP: Add Server
2. Select HTTP transport and use:

{
    "servers": {
        "todoist": {
            "type": "http",
            "url": "https://ai.todoist.net/mcp"
        }
    }
}

Other MCP Clients

npx -y mcp-remote https://ai.todoist.net/mcp

For more details on setting up and using the MCP server, including creating custom servers, see docs/mcp-server.md.

MCP Server Setup

See docs/mcp-server.md for full instructions on setting up the MCP server.

Local Development Setup

See docs/dev-setup.md for full setup instructions and CONTRIBUTING.md for contributor workflows and quality checks.

Quick Start

You can run the MCP server directly with npx:

npx @doist/todoist-mcp

Quick Start

After cloning and setting up the repository:

• npm start - Build and run the MCP inspector for testing
• npm run dev - Development mode with auto-rebuild and restart
• npm run tool:list - List available tools for direct execution
• npm run tool -- <tool-name> '<json-args>' - Run a tool directly without MCP

When using npm run tool, include -- before tool arguments so npm forwards them to scripts/run-tool.ts.

Example check before write operations: npm run tool -- user-info '{}' This confirms which Todoist account the current TODOIST_API_KEY is connected to.

run-tool uses TODOIST_API_KEY from your .env file (created from .env.example by npm run setup). Use a test account or a temporary project when running write operations to avoid modifying real data.