
Todoist
MCP server giving AI clients read access to Todoist projects, tasks, sections and labels
- Pricing
- Freemium
- Platforms
- API, CLI, Web
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Todoist
Todoist is a freemium MCP server for productivity. It can run locally on your machine or as a hosted remote server.
The README describes this as a Pipeworx pack that connects an AI client to a Todoist account through the Pipeworx gateway. Once connected, a client can enumerate projects, pull active tasks with optional project or filter-query narrowing, open a single task for its full fields, and read the sections and labels that organize them. Requests are routed through the hosted gateway rather than run locally, so calls are metered under Pipeworx's own limits.
The README notes that the endpoint also exposes shared gateway meta-tools such as ask_pipeworx, so the tool list a client sees is larger than the five Todoist tools. It is an independent, unofficial integration and is not published by Todoist. The connection requires a Todoist account linked through Pipeworx, and an optional Pipeworx API key raises the daily call cap for anonymous use.
This suits people who want an assistant to check due dates, overdue items or labelled work in Todoist without writing to the account, since the listed tools only read data.
Install
Run in a terminal
claude mcp add --transport http todoist https://gateway.pipeworx.io/todoist/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/todoist/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"todoist": {
"url": "https://gateway.pipeworx.io/todoist/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"todoist": {
"type": "http",
"url": "https://gateway.pipeworx.io/todoist/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"todoist": {
"serverUrl": "https://gateway.pipeworx.io/todoist/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"todoist": {
"type": "http",
"url": "https://gateway.pipeworx.io/todoist/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- todoist_list_projects
- List all projects in the user's Todoist account, with id, name, colour, favourite status, web URL and parent project id.
- todoist_list_tasks
- List active (incomplete) tasks, optionally filtered by project id or a Todoist filter query.
- todoist_get_task
- Get full details of a single task by id, including content, description, priority, due date, labels and creation time.
- todoist_list_sections
- List the sections within a Todoist project with their id, project id, name and order.
- todoist_list_labels
- List all personal labels with their id, name, colour and favourite status.
What it does
- List projects
- Returns each project's id, name, colour, favourite status, web URL and parent project.
- Filter active tasks
- Lists incomplete tasks, optionally by project id or a Todoist filter query such as today or overdue.
- Inspect a single task
- Fetches content, description, priority, due date, labels and creation time for one task id.
- Browse sections
- Shows the sections inside a project with their ids, names and ordering.
- Read labels
- Lists personal labels with their ids, colours and favourite status.
- Gateway meta-tools included
- The endpoint also lists shared Pipeworx tools like ask_pipeworx for questions beyond Todoist.
Good for
- Asking an assistant what is due today or overdue in Todoist
- Reviewing high-priority tasks filtered by project or label
- Summarising how tasks are organised into sections within a project
- Pulling task details into a note or report without opening the Todoist app
Pricing
Freemium, from $49 a month
Free anonymous and registered tiers; paid credits and $49/$99 monthly subscriptions for more usage.
Prices change. Check pipeworx.io before you buy.
Todoist FAQ
Can this server create or change Todoist tasks?
The listed tools only list projects, tasks, sections and labels, and fetch single tasks, so the README describes read access only.
Do I need a key to use it?
Without a Pipeworx key calls are anonymous and capped at 50 per day. A free account raises the cap to 200 per day.
Is this an official Todoist product?
No. The README states it is an independent, unofficial integration not affiliated with or endorsed by Todoist.
How is it priced?
Pipeworx offers a free anonymous tier and a free registered tier, with paid credits and subscriptions for higher usage. The README does not describe Todoist-specific pricing.
Is Todoist free?
Todoist has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.
How do I add Todoist to Claude Code?
Run this command in your terminal: claude mcp add --transport http todoist https://gateway.pipeworx.io/todoist/mcp
What are the best alternatives to Todoist?
The closest alternatives to Todoist are Jira, To-do Calendar, Task Board Todo Kanban, Nozbe Teams MCP by usefulapi and GetItDone.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.
