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
add-tasks	Create one or more tasks
find-tasks	Search and filter tasks
find-tasks-by-date	Find tasks by due date or date range
find-completed-tasks	Find previously completed tasks
update-tasks	Update existing tasks
complete-tasks	Mark tasks as complete
uncomplete-tasks	Reopen completed tasks
reschedule-tasks	Change task due dates

Projects

Tool	Description
add-projects	Create new projects
find-projects	Search and list projects
update-projects	Update project properties
project-management	Archive or unarchive projects
project-move	Move projects between workspaces

Sections

Tool	Description
add-sections	Create sections within projects
find-sections	Search and list sections
update-sections	Update section properties

Comments

Tool	Description
add-comments	Add comments to tasks or projects
find-comments	Search and list comments
update-comments	Update existing comments
view-attachment	View file attachments on comments

Labels

Tool	Description
add-labels	Create new labels
find-labels	Search and list labels

Filters

Tool	Description
add-filters	Create saved filters
find-filters	Search and list filters
update-filters	Update existing filters

Collaboration

Tool	Description
find-project-collaborators	List collaborators on a project
manage-assignments	Assign or unassign tasks
list-workspaces	List available workspaces

General

Tool	Description
get-overview	Get a summary of your Todoist account
search	Full-text search across Todoist
fetch	Fetch a Todoist URL
fetch-object	Fetch a specific task, project, section, or comment by ID
delete-object	Delete a task, project, section, label, or other object
reorder-objects	Reorder tasks, projects, or sections
find-activity	View activity/audit log
get-productivity-stats	Get your productivity statistics
user-info	Get current user information

Environment Variables

Variable	Required	Description
TODOIST_API_KEY	Yes	Your Todoist API token (get it from Settings > Integrations > Developer)

Installation

npm ci

Usage

Stdio mode (for Claude Desktop, etc.)

TODOIST_API_KEY=your_api_key node dist/main.js

Or create a .env file with your API key:

TODOIST_API_KEY=your_api_key

Then run:

node dist/main.js

HTTP mode (standalone server)

TODOIST_API_KEY=your_api_key node dist/main-http.js

The 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.js

Claude 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