# Todoist

> Todoist is a freemium MCP server for productivity. MCP server giving AI clients read access to Todoist projects, tasks, sections and labels. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, Web, self-hosted
- **Website:** https://pipeworx.io/packs/todoist
- **Repository:** https://github.com/pipeworx-io/mcp-todoist
- **MCP Registry name:** io.github.pipeworx-io/todoist
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http todoist https://gateway.pipeworx.io/todoist/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/todoist/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "todoist": {
      "url": "https://gateway.pipeworx.io/todoist/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "todoist": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/todoist/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "todoist": {
      "serverUrl": "https://gateway.pipeworx.io/todoist/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "todoist": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/todoist/mcp"
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [Jira](https://ai-powered.com/mcp/jira): Jira is a freemium MCP server for productivity.
- [To-do Calendar](https://ai-powered.com/mcp/to-do-calendar): To-do Calendar is an MCP server for productivity.
- [Task Board Todo Kanban](https://ai-powered.com/mcp/task-board-todo-kanban): Task Board Todo Kanban is a freemium MCP server for productivity.
- [Nozbe Teams MCP by usefulapi](https://ai-powered.com/mcp/nozbe-teams-mcp-by-usefulapi): Nozbe Teams MCP by usefulapi is a freemium MCP server for communication.
- [GetItDone](https://ai-powered.com/mcp/getitdone): GetItDone is a freemium MCP server for productivity.
- [Notion_connect](https://ai-powered.com/mcp/notion-connect): Notion_connect is a freemium MCP server for knowledge and memory.
- [Teamwork.com](https://ai-powered.com/mcp/teamwork-com): Teamwork.com is a freemium MCP server for productivity.
- [TeamGantt MCP by usefulapi](https://ai-powered.com/mcp/teamgantt-mcp-by-usefulapi): TeamGantt MCP by usefulapi is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/todoist
