Skip to content
MCP server

Todoist

MCP server giving AI clients read access to Todoist projects, tasks, sections and labels

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/todoist/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "todoist": {
      "url": "https://gateway.pipeworx.io/todoist/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers