Todoist MCP
About
Manage your Todoist tasks and projects directly from your LLM.
Details
- Author
- doist
- Categories
- Remote MCP, Productivity, Project Management
Jump to
Setup
Install Todoist MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/doist/todoist-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
- Find tasks by date— Ask your assistant to locate tasks scheduled for a specific day usingfindTasksByDate.
- Add new tasks— Have your assistant create one or more Todoist tasks for you via theaddTaskstool.
- Check account identity— Ask which Todoist account is connected before making changes, usinguser-infoto confirm the active user.
- Run tools directly— Usenpm run toolto 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 usingVercel'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
- Enterhttps://ai.todoist.net/mcpand complete OAuth authentication
- 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.
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. SeeAnthropic'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 launchclaude, execute/mcp, and select thetodoistMCP 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, seedocs/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, seedocs/tool-design.md.
For a complete list of available tools, see thesrc/toolsdirectory.
This server includessearchandfetchtools that follow theOpenAI 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@modelcontextprotocol/server
- Todoist Typescript API client@doist/todoist-sdk
Seedocs/mcp-server.mdfor full instructions on setting up the MCP server.
Seedocs/dev-setup.mdfor full setup instructions andCONTRIBUTING.mdfor contributor workflows and quality checks.
This project includes support forMCP 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.
Seedocs/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 usingnpm run tool, include--before tool arguments so npm forwards them toscripts/run-tool.ts.
Example check before write operations:npm run tool -- user-info '{}'This confirms which Todoist account the currentTODOIST_API_KEYis connected to.
run-toolusesTODOIST_API_KEYfrom your.envfile (created from.env.examplebynpm run setup). Use a test account or a temporary project when running write operations to avoid modifying real data.
- Development workflow
- Running tools directly withscripts/run-tool.ts
- Testing and quality checks
- Commit conventions
This project usesrelease-pleaseto automate version management and package publishing.
-
Make your changes usingConventional Commits:
- feat:for new features (minor version bump)
- fix:for bug fixes (patch version bump)
- feat!:orfix!: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
- Thepublishworkflow 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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



