← Back to directory

Todoist MCP Server

Community

Manage Todoist tasks and projects through natural language with Claude

GitHub source repository ↗

★ 243 Stars Category · Collaboration Popular Source revision fc8d80599334

61FMRS · C

Reliability

9/20

Security and permissions

10/20

Maintenance

13/20

Documentation

16/20

Setup experience

13/20

A community-maintained Todoist MCP server offering 19 tools spanning tasks, projects, and collaboration, with practical features like bulk operations and a Dry-Run simulation mode. The maintainer enforces a strict contribution process (single-concern PRs, verification against the live API), and documentation is thorough, but users are responsible for managing the API token securely and for the data-change risk of bulk operations.

Read the FMRS scoring method →

An open-source MCP server that connects Claude to Todoist for complete task and project management through natural language. It exposes 19 tools covering tasks, subtasks, projects, sections, labels, comments, reminders, filters, collaboration, user profile, activity logs, completed tasks, backups, notes, and shared labels, with support for bulk operations and Todoist's Quick Add natural-language parsing. A built-in Dry-Run mode lets you validate operations against real data without making actual changes.

Tools

todoist_task

Create, get, update, delete, complete, and reopen tasks, with priorities, due dates, labels, and Quick Add natural-language parsing

todoist_task_bulk

Bulk create, update, delete, and complete tasks for efficient multi-task operations

todoist_subtask

Create subtasks, bulk-create, convert tasks to subtasks, promote subtasks to tasks, and view task hierarchy

todoist_project

Project create, get, update, delete, archive, and collaborator management

todoist_project_ops

Advanced project operations: reorder, move to parent, get archived projects

todoist_section

Section create, get, update, delete, move, reorder, and archive

todoist_label

Label create, get, update, delete, and usage statistics

todoist_comment

Create, get, update, and delete task/project comments

todoist_reminder

Reminder (Pro) create, get, update, and delete

todoist_filter

Custom filter (Pro) create, get, update, and delete

todoist_collaboration

Team collaboration features: invitations, notifications, and workspace operations

todoist_user

User profile info, productivity stats, and karma history

todoist_utility

Connection, feature, and performance testing, plus duplicate task find/merge utilities

todoist_activity

Retrieve activity log, events, and activity summaries for audit trails

todoist_task_ops

Advanced task operations: move, reorder, close

todoist_completed

Retrieve completed tasks, get all completed tasks, and completion statistics

todoist_backup

List and download Todoist's automatic backups

todoist_notes

Create, get, update, and delete project notes (for collaborators)

todoist_shared_labels

Workspace shared label (Business) create, get, rename, and remove

Setup

1) Claude Desktop users can download the todoist-mcp.mcpb file from the latest GitHub release and double-click or drag it onto Claude Desktop, then enter a Todoist API token when prompted; 2) Claude Code or other MCP clients can run claude mcp add todoist -e TODOIST_API_TOKEN=your_token -- npx @greirson/mcp-todoist; 3) alternatively, edit claude_desktop_config.json or ~/.claude.json manually, adding an mcpServers entry with command npx, args ["@greirson/mcp-todoist"], and env TODOIST_API_TOKEN set to your token; 4) to test safely without affecting real data, add DRYRUN=true to the env block to enable dry-run mode.

claude_desktop_config.json

{"mcpServers":{"todoist":{"command":"npx","args":["@greirson/mcp-todoist"],"env":{"TODOIST_API_TOKEN":"your_api_token_here"}}}}

Generate and validate client config

Fit and risk

Best for

Existing Todoist users or teams who want to manage tasks and projects through conversation with Claude
Users who need to run bulk task operations (e.g., mass priority updates, clearing overdue tasks)
Developers who want to validate automations in Dry-Run mode before touching real data

Not for

Users who don't use Todoist, or who need to connect to other task tools like Jira or Asana
Enterprise scenarios requiring an official Todoist product or SLA-backed support
Highly privacy-sensitive setups that don't want API tokens and task data routed through a third-party MCP server

Required permissions

Requires a personal Todoist API token (from Todoist developer settings), which grants account-level read/write access
Can read and modify all account data including tasks, projects, sections, labels, comments, reminders, filters, notes, and shared labels
Some features (reminders, filters, shared labels) require a Todoist Pro or Business subscription

Risks and side effects

This is a third-party open-source project maintained by an individual developer, not an official Todoist product
The API token is stored in plaintext in the client config file and should be protected from exposure
Bulk delete or bulk complete operations can make irreversible changes to real Todoist data if misconfigured; test with DRYRUN=true first
Task and comment content passes through Claude, so users with sensitive data should evaluate their own data-flow risk

Troubleshooting

If you see "No Todoist projects found" or connection errors, verify the API token is correct and free of extra spaces or quotes in the config
If the MCP server doesn't load, confirm the package is installed globally (npm list -g @greirson/mcp-todoist) and fully restart Claude Desktop
Check that the config file path matches your OS (macOS/Windows/Claude Code differ), and try the full path to the mcp-todoist binary if needed
On macOS/Linux, permission errors may require manually creating the config directory (e.g., mkdir -p ~/.config) and ensuring Claude Desktop can read it

Use cases

Create, update, and complete Todoist tasks and subtasks using natural language

Bulk create, update, or delete multiple tasks for efficiency

Quickly capture tasks with dates, projects, labels, and priority via Quick Add syntax

Manage projects, sections, labels, comments, and reminders

Validate bulk operations and automation scripts with Dry-Run mode before running them for real

Supported clients

Claude DesktopFull support

Claude CodeFull support

Related MCP servers

Compare with other MCP servers