todoist-mcp
Provides comprehensive access to Todoist, enabling AI assistants to manage tasks, projects, sections, comments, labels, and filters, as well as track productivity and search across the account.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@todoist-mcpList all my tasks due today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
todoist-mcp
An MCP (Model Context Protocol) server for Todoist that gives AI assistants full access to your tasks, projects, labels, filters, comments, and more.
Built on the official @doist/todoist-ai package.
Tools
Tasks
Tool | Description |
| Create one or more tasks |
| Search and filter tasks |
| Find tasks by due date or date range |
| Find previously completed tasks |
| Update existing tasks |
| Mark tasks as complete |
| Reopen completed tasks |
| Change task due dates |
Projects
Tool | Description |
| Create new projects |
| Search and list projects |
| Update project properties |
| Archive or unarchive projects |
| Move projects between workspaces |
Sections
Tool | Description |
| Create sections within projects |
| Search and list sections |
| Update section properties |
Comments
Tool | Description |
| Add comments to tasks or projects |
| Search and list comments |
| Update existing comments |
| View file attachments on comments |
Labels
Tool | Description |
| Create new labels |
| Search and list labels |
Filters
Tool | Description |
| Create saved filters |
| Search and list filters |
| Update existing filters |
Collaboration
Tool | Description |
| List collaborators on a project |
| Assign or unassign tasks |
| List available workspaces |
General
Tool | Description |
| Get a summary of your Todoist account |
| Full-text search across Todoist |
| Fetch a Todoist URL |
| Fetch a specific task, project, section, or comment by ID |
| Delete a task, project, section, label, or other object |
| Reorder tasks, projects, or sections |
| View activity/audit log |
| Get your productivity statistics |
| Get current user information |
Environment Variables
Variable | Required | Description |
| Yes | Your Todoist API token (get it from Settings > Integrations > Developer) |
Installation
npm ciUsage
Stdio mode (for Claude Desktop, etc.)
TODOIST_API_KEY=your_api_key node dist/main.jsOr create a .env file with your API key:
TODOIST_API_KEY=your_api_keyThen run:
node dist/main.jsHTTP mode (standalone server)
TODOIST_API_KEY=your_api_key node dist/main-http.jsThe server starts on port 3000 by default (set PORT to override). The MCP endpoint is at /mcp and a health check is at /health.
HTTP mode with mcp-proxy
mcp-proxy --port 8006 -- node dist/main.jsClaude Desktop configuration
Add to your Claude Desktop MCP config:
{
"mcpServers": {
"todoist": {
"command": "node",
"args": ["/path/to/todoist-mcp/dist/main.js"],
"env": {
"TODOIST_API_KEY": "your_api_key"
}
}
}
}License
MIT
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/GraysonCAdams/todoist-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server