stanislavlysenko0912/todoist-mcp-server

A Model Context Protocol (MCP) server implementation that integrates Claude and other AI assistants with Todoist, enabling natural language task management.
Features
- **Complete Todoist API Integration**: Access to the full Todoist REST API v2, and support for the Todoist Sync API through natural language
- **Batch Processing**: Client can process multiple tasks in a single request
- **Search by name**: AI can search for tasks, projects, and labels by name instead of ID
- **Tasks**: Create, update, close, reopen, move, and delete tasks using conversational language
- **Projects**: Create and manage projects and sections
- **Comments**: Add and manage comments on tasks and projects
- **Labels**: Create and manage personal and shared labels
- **Smart Context**: On startup, automatically provides your projects and labels to the AI via server instructions — no extra tool calls needed
- **Prompt Support**: You can easily provide information about your projects to client
Configuration
You'll need a Todoist API token to use this MCP server.
Getting a Todoist API Token
1. Log in to your Todoist account
2. Navigate to Settings → Integrations
3. Find your API token under "Developer"
Usage
Add to mcpServers in your platform config:
| Platform | Config |
|----------|--------|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\ (Windows) |
| Claude Code | .mcp.json — claude mcp add --transport stdio --scope project --env API_KEY=token todoist -- npx -y todoist-mcp |
| Cursor | ~/.cursor/mcp.json or .cursor/mcp.json |
| Codex | ~/.codex/config.toml or .codex/config.toml — see example below |
| Gemini CLI | ~/.gemini/settings.json — gemini mcp add -e API_KEY=token todoist npx -y todoist-mcp |
**Codex** — CLI:
Or add to config.toml:
Available Tools
Tasks
- get_tasks_list: Get tasks with optional filtering by project, section, label, or IDs
- get_tasks_by_filter: Get tasks using Todoist filter language (e.g. "today", "overdue", "P1 | P2", "#Work & @urgent")
- create_tasks: Create new tasks with various attributes
- get_tasks: Get specific tasks by ID or name
- update_tasks: Update existing tasks
- close_tasks: Mark tasks as complete
- reopen_tasks: Reopen completed tasks
- delete_tasks: Delete tasks
- move_tasks: Move tasks to a different project or section
Projects
- get_projects_list: Get all projects
- create_projects: Create new projects
- get_projects: Get specific projects by ID or name
- update_projects: Update existing projects
- delete_projects: Delete projects
- get_collaborators: Get all collaborators for a project
- move_projects: Move projects to a different location or subproject
Sections
- get_sections_list: Get all sections or filter by project
- create_sections: Create new sections
- get_sections: Get specific sections by ID or name
- update_sections: Update sections