Todoist MCP

- **Find tasks by date**— Ask your assistant to locate tasks scheduled for a specific day using`findTasksByDate`. - **Add new tasks**— Have your assistant create one or more Todoist tasks for you via the`addTasks`tool. - **Check account identity**— Ask which Todoist account is connected before making changes, using`user-info`to confirm the active user. - **Run tools directly**— Use`npm run tool`to execute any tool standalone with JSON arguments, bypassing the MCP server. Library for connecting AI agents to Todoist. Includes tools that can be integrated into LLMs, enabling them to access and modify a Todoist account on the user's behalf. These tools can be used both through an MCP server, or imported directly in other projects to integrate them to your own AI conversational interfaces. ### 2. Import the tools and plug them to an AI Here's an example using[Vercel's AI SDK. ``` `import { findTasksByDate, addTasks } from '@doist/todoist-mcp' import { TodoistApi } from '@doist/todoist-sdk' import { streamText } from 'ai' // Create Todoist API client const client = new TodoistApi(process.env.TODOIST_API_KEY) // Helper to wrap tools with the client function wrapTool(tool, todoistClient) { return { ...tool, execute(args) { return tool.execute(args, todoistClient) }, } } const result = streamText({ model: yourModel, system: 'You are a helpful Todoist assistant', tools: { findTasksByDate: wrapTool(findTasksByDate, client), addTasks: wrapTool(addTasks, client), }, })` ``` You can run the MCP server directly with npx: 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` - Open Settings → Connectors → Add custom connector - Enter`https://ai.todoist.net/mcp`and complete OAuth authentication - **Global:**`~/.cursor/mcp.json` - **Project-specific:**`.cursor/mcp.json` ``` `{ "mcpServers": { "todoist": { "command": "npx", "args": ](https://ai-sdk.dev/docs/ai-sdk-core/generating-text#streamtext)["-y", "mcp-remote", "https://ai.todoist.net/mcp"] } } }` ``` Then enable the server in Cursor settings if prompted. 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 docsfor 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. - Open Command Palette → MCP: Add Server - Select HTTP transport and use: ``` `{ "servers": { "todoist": { "type": "http", "url": "https://ai.todoist.net/mcp" } } }` ``` ``` `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](https://code.claude.com/docs/en/plugins-reference)[docs/mcp-server.md. A key feature of this project is that tools can be reused, and are not written specifically for use in an MCP server. They can be hooked up as tools to other conversational AI interfaces (e.g. Vercel's AI SDK). This project is in its early stages. Expect more and/or better tools soon. Nevertheless, our goal is to provide a small set of tools that enable complete workflows, rather than just atomic actions, striking a balance between flexibility and efficiency for LLMs. For our design philosophy, guidelines, and development patterns, see](https://github.com/Doist/todoist-mcp/blob/HEAD/docs/mcp-server.md)[docs/tool-design.md. For a complete list of available tools, see the](https://github.com/Doist/todoist-mcp/blob/HEAD/docs/tool-design.md)[src/toolsdirectory. This server includes`search`and`fetch`tools that follow the](https://github.com/Doist/todoist-mcp/blob/HEAD/src/tools)[OpenAI MCP specification, enabling seamless integration with OpenAI's MCP protocol. These tools return JSON-encoded results optimized for OpenAI's requirements while maintaining compatibility with the broader MCP ecosystem. - MCP server using the official](https://platform.openai.com/docs/mcp)[@modelcontextprotocol/server - Todoist Typescript API client](https://github.com/modelcontextprotocol/typescript-sdk)[@doist/todoist-sdk See](https://github.com/Doist/todoist-sdk)[docs/mcp-server.mdfor full instructions on setting up the MCP server. See](https://github.com/Doist/todoist-mcp/blob/HEAD/docs/mcp-server.md)[docs/dev-setup.mdfor full setup instructions and](https://github.com/Doist/todoist-mcp/blob/HEAD/docs/dev-setup.md)[CONTRIBUTING.mdfor contributor workflows and quality checks. This project includes support for**MCP Apps**– interactive UI widgets rendered inline in AI chat interfaces. Widgets provide rich visual representations of tool outputs (e.g., task lists) instead of plain text. See](https://github.com/Doist/todoist-mcp/blob/HEAD/CONTRIBUTING.md)[docs/mcp-apps.mdfor the widget architecture, build pipeline, and development workflow. 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. - Development workflow - Running tools directly with`scripts/run-tool.ts` - Testing and quality checks - Commit conventions This project uses](https://github.com/Doist/todoist-mcp/blob/HEAD/docs/mcp-apps.md)[release-pleaseto automate version management and package publishing. - Make your changes using](https://github.com/googleapis/release-please)[Conventional Commits: - `feat:`for new features (minor version bump) - `fix:`for bug fixes (patch version bump) - `feat!:`or`fix!:`for breaking changes (major version bump) - `docs:`for documentation changes - `chore:`for maintenance tasks - `ci:`for CI changes - Release-please automatically creates/updates a release PR - The PR includes version bump and changelog updates - Review the PR and merge when ready - A new GitHub release is automatically created - A new tag is created - The`publish`workflow is triggered - The package is published to npm Todoist runs an official remote MCP server — connect over a hosted URL instead of installing this one locally. Interact with task, doc, and project data in Dart, an AI-native project management tool Remote MCP server for MeisterTask. Create and manage projects, tasks, and notes from your AI assistant. Hosted (streamable-HTTP) — connect at https://mcp.meistertask.com/mcp The official Plane MCP server provides integration with Plane APIs, enabling full AI automation of Plane projects, work items, cycles and more. Keep teams & agents coordinated automatically From the creators of Wunderlist — the all-in-one task management app for to-do lists, notes, and projects. AI-powered productivity that replaces 5 apps. Connect to the Taskade platform via MCP. Access tasks, projects, workflows, and AI agents in real-time through a unified workspace and API. Official Taskeract MCP Server for integrating your Taskeract project tasks and load the context of your tasks into your MCP enabled app. Interact with Asana tasks, projects, workspaces, and comments using the Asana API. Comprehensive Trello integration: 46 tools covering boards, cards, lists, labels, checklists, attachments, members, custom fields, and search. Read-only mode, image attachment auto-download. Active fork of kocakli/Trello-Desktop-MCP integrating contributions from across the Trello MCP fork ecosystem The Outcome Backcasting MCP is a strategic planning tool that helps you work backwards from a desired future outcome to identify the specific steps, resources, and dependencies needed to achieve your goals. Unlike traditional forward planning, backcasting starts with your end goal and creates a reverse roadmap to get there.](https://www.conventionalcommits.org/)