Best for
- Existing Todoist users on Claude Desktop, Cursor, Codex, or Gemini CLI who want AI-driven task management
- Users needing batch task operations and filter-language queries
T
Todoist MCP Server
Community
Manage Todoist tasks, projects, comments, and labels via natural language with MCP
GitHub source repository ↗
53FMRS · D
A community-maintained MCP server based on the README, offering full Todoist REST API v2 coverage plus Sync API support across tasks, projects, sections, comments, and labels, with batch operations and natural-language interaction. Documentation is clear and multiple mainstream MCP clients are supported. Best for heavy Todoist users, with attention to its unofficial status and token security.
A community-maintained Model Context Protocol (MCP) server that integrates Claude and other AI assistants with Todoist. It provides a full implementation of the Todoist REST API v2 and supports the Todoist Sync API, enabling natural-language creation, update, closure, reopening, moving, and deletion of tasks, plus management of projects, sections, comments, and personal/shared labels. On startup it supplies your projects and labels to the AI via server instructions, and it supports batch processing and search by name instead of ID.
Tools
get_tasks_list
Get tasks with optional filtering by project, section, label, or IDs
get_tasks_by_filter
Query tasks using Todoist filter language (e.g. today, overdue, P1 | P2)
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
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
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
delete_sections
Delete sections
get_comments_list
Get comments for a project or task
create_comments
Create new comments
get_comments
Get specific comments by ID
update_comments
Update comments
delete_comments
Delete comments
get_labels_list
Get all personal labels
create_labels
Create new personal labels
get_labels
Get personal labels by ID or name
update_labels
Update personal labels
delete_labels
Delete personal labels
get_shared_labels
Get all shared labels
rename_shared_labels
Rename shared labels
remove_shared_labels
Remove shared labels
utils_get_colors
Get available colors for projects, labels, and filters
projects_list
Prompt returning projects with their sections and params in markdown format
Setup
Obtain your API token from Todoist under Settings → Integrations → Developer, then add to your client's mcpServers config: command npx, args ["-y","todoist-mcp"], and env API_KEY set to your Todoist API token.
claude_desktop_config.json
{"mcpServers":{"todoist":{"command":"npx","args":["-y","todoist-mcp"],"env":{"API_KEY":"your_todoist_api_token"}}}}
Fit and risk
Not for
- Users who do not use Todoist
- Users requiring official Todoist support or guarantees (community project, MIT licensed)
Required permissions
- Requires a Todoist API token with full read/write access to tasks, projects, sections, comments, and labels in that account
Risks and side effects
- API token leakage could expose task data to viewing, modification, or deletion
- AI misinterpretation could accidentally delete or alter tasks and projects
- Third-party community project, not maintained by Todoist
Troubleshooting
- Verify the API_KEY environment variable is set to a valid Todoist API token
- Check the token in Todoist under Settings → Integrations → Developer
- Ensure Node.js is installed and npx is available
- Use @modelcontextprotocol/inspector to debug server connectivity
Use cases
Query today's or high-priority tasks conversationally
Create, complete, or reopen tasks through natural language
Manage projects, sections, comments, and labels
Batch-retrieve tasks using Todoist filter language
Supported clients
Claude DesktopFull support
Claude CodeFull support
CursorFull support
CodexFull support
Gemini CLIFull support