How do I use Todoist MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Todoist MCP Server list 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 Server

by A-J-C

Overview Schema Source Related Servers Discussions Admin

TypeScript

Todoist MCP Server

A Model Context Protocol (MCP) server for the Todoist API v1. Provides 44 tools with read-only/write annotations so Claude Desktop groups them correctly.

Install in Claude Desktop (recommended)

Download or build todoist-mcp-server.mcpb, then double-click it (or drag it into Claude Desktop → Settings → Extensions). Claude Desktop will prompt for your Todoist API Token during install.

Get your API token from: https://app.todoist.com/app/settings/integrations/developer

Build the .mcpb from source

Requires just (brew install just):

just bundle

That installs deps, compiles, stages a clean dependency tree, and packs todoist-mcp-server.mcpb at the repo root. Other recipes: just build, just run, just clean. Run just with no args to list them all.

Related MCP server: Todoist MCP

Manual configuration (alternative)

If you'd rather wire up the server directly without packaging:

just build

Create a .env file:

TODOIST_API_TOKEN=your_todoist_api_token_here

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "todoist": {
      "command": "node",
      "args": ["/path/to/todoist-mcp-server/dist/index.js"],
      "env": {
        "TODOIST_API_TOKEN": "your_token_here"
      }
    }
  }
}

Tools (44 total)

Read-only (22)

Tool	Description
`find-tasks-by-date`	Find tasks by due date range
`fetch`	Fetch any Todoist API URL directly
`fetch-object`	Get a specific object by type and ID
`find-activity`	Recent activity (completed tasks)
`find-comments`	Comments on tasks or projects
`find-completed-tasks`	Completed tasks with date filtering
`find-filters`	User-defined filters (guidance — managed via app)
`find-labels`	Personal labels
`find-project-collaborators`	Project collaborators
`find-projects`	All projects
`find-reminders`	All reminders
`find-sections`	Sections (optionally by project)
`find-tasks`	Active tasks with filtering
`get-overview`	Workspace overview with task counts
`get-productivity-stats`	Karma, streaks, daily/weekly trends
`get-project-activity-stats`	Completed tasks for a project
`get-project-health`	Project health analysis
`get-workspace-insights`	Cross-workspace analytics
`list-workspaces`	User account and workspace info
`search`	Search tasks by content, description, or label
`user-info`	Authenticated user details
`view-attachment`	View comment attachments
`analyze-project-health`	Deep project health analysis with suggestions

Write (19)

Tool	Description
`add-comments`	Add comments to tasks/projects
`add-filters`	Create filters (guidance — managed via app)
`add-labels`	Create personal labels
`add-projects`	Create projects
`add-reminders`	Add task reminders (requires Pro)
`add-sections`	Create project sections
`add-tasks`	Create tasks with subtasks, labels, priorities, due dates
`complete-tasks`	Mark tasks complete
`manage-assignments`	Assign/unassign tasks in shared projects
`project-management`	Bulk project update/delete
`project-move`	Reposition a project by order
`reorder-objects`	Reorder tasks, projects, or sections
`reschedule-tasks`	Bulk reschedule task due dates
`uncomplete-tasks`	Reopen completed tasks
`update-comments`	Update comment content
`update-filters`	Update filters (guidance — managed via app)
`update-projects`	Update project properties
`update-reminders`	Update reminder settings
`update-sections`	Update section names
`update-tasks`	Update tasks (including move between sections/projects)

Destructive (1)

Tool	Description
`delete-object`	Delete any object (task, project, section, comment, label)

API Coverage

Uses the Todoist API v1 (https://api.todoist.com/api/v1/). Handles paginated responses automatically.

Resource	Read	Create	Update	Delete	Move
Tasks	Yes	Yes	Yes	Yes	Yes
Projects	Yes	Yes	Yes	Yes	Yes (reorder)
Sections	Yes	Yes	Yes	Yes	—
Comments	Yes	Yes	Yes	Yes	—
Labels	Yes	Yes	Yes	Yes	—
Reminders	Yes	Yes	Yes	—	—
Completed tasks	Yes	—	—	—	—
Productivity stats	Yes	—	—	—	—
User info	Yes	—	—	—	—
Collaborators	Yes	—	—	—	—

Notes

Filters: The Todoist API v1 does not expose filter CRUD. The add-filters/update-filters tools return guidance to use the Todoist app. Use find-tasks with parameters for filter-like behavior.
Reminders: Require Todoist Pro plan. The tools work correctly but will return HTTP 403 on free accounts.
Tool annotations: All tools include readOnlyHint/destructiveHint so Claude Desktop groups them into read-only, write, and destructive categories.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

mcpOAuth
net.todoist
Official Todoist MCP server for AI assistants to manage tasks, projects, and workflows.
App Automation Workplace & Productivity Project Management
2
Tack
io.github.Thefirstmannnn
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Project Management Workplace & Productivity
1
OrbitOAuth
io.github.Noveum
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Project Management Workplace & Productivity
130
mcp
io.lucidnest
ADHD-friendly tasks, notes & projects for LucidNest - 18 tools, scoped tokens, Streamable HTTP.
Note Taking Project Management
2

Related MCP Servers

Todoist MCP
App Automation Project Management
Scofieldkoh
A
license
Not graded
quality
D
maintenance
Enables LLMs to interact with Todoist task management platform through its API, supporting all features from the official Todoist TypeScript Client.
Updated a year ago (2025-05-05 00:59 UTC)
330 npm
MIT
Todoist MCP
App Automation Workplace & Productivity Project Management
miottid
A
license
Not graded
quality
D
maintenance
Enables LLMs to interact with Todoist for comprehensive task and project management, including creating tasks with natural language, managing projects, sections, labels, comments, and tracking productivity statistics.
Updated a year ago (2025-07-15 19:10 UTC)
330 npm
4
MIT
Todoist MCP Server
App Automation Project Management Workplace & Productivity
strangetoucane
A
license
Not graded
quality
D
maintenance
Enables AI assistants to manage Todoist tasks, projects, comments, and labels through natural language commands. Provides complete CRUD operations securely via the Todoist REST API v2.
Updated 9 months ago (2025-12-08 17:01 UTC)
Apache 2.0
Todoist MCP Server
Project Management Workplace & Productivity App Automation
koki-develop
A
license
Not graded
quality
F
maintenance
Enables AI assistants to manage Todoist tasks, projects, sections, labels, and comments through natural language conversations, providing complete control over your productivity workflow via the Todoist API.
Updated 6 months ago (2026-03-30 20:50 UTC)
271 npm
7
MIT