Advertise
MCP.so
Sign In

Todoist MCP Server

@greirson

Repository

Basic information

Category

Productivity

License

MIT

Transports

stdio

Author

greirson

About Todoist MCP Server

MCP server that connects Claude to Todoist for natural language task and project management with bulk operations

Todoist MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": [
        "@greirson/mcp-todoist"
      ],
      "env": {
        "TODOIST_API_TOKEN": ""
      }
    }
  }
}

Todoist MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Todoist MCP Server?

The Todoist MCP Server connects Claude with Todoist via the Model Context Protocol, enabling complete task and project management through natural language commands. It provides 19 MCP tools to manage tasks, projects, sections, labels, reminders, comments, and more.

How to use Todoist MCP Server?

Install via one-click by downloading the .mcpb file from the latest release and double-clicking it on Claude Desktop, then entering your Todoist API token. Alternatively, add it manually to your MCP client configuration (claude_desktop_config.json or ~/.claude.json) with npx @greirson/mcp-todoist and set the TODOIST_API_TOKEN environment variable. Enable dry-run mode by adding DRYRUN=true to the environment to simulate operations without real changes.

Key features of Todoist MCP Server

  • 19 MCP tools for complete Todoist management
  • Task creation, update, delete, complete, reopen with priorities and due dates
  • Bulk operations on multiple tasks efficiently
  • Subtask hierarchy with completion tracking
  • Projects, sections, labels, filters, and reminders
  • Natural language quick add with Todoist parsing
  • Dry-run mode to test operations without mutation

Use cases of Todoist MCP Server

  • Manage your entire Todoist workspace through Claude chat
  • Run bulk updates or completions on many tasks at once
  • Test new automations or workflows safely with dry-run mode
  • Explore the Todoist API and learn tool capabilities without risk
  • Automate project setup and recurring task creation

Frequently asked questions

1

How do I install the Todoist MCP Server?

Use the one-click `.mcpb` file from the latest GitHub release, or add the server manually to your MCP client configuration with `npx @greirson/mcp-todoist` and your Todoist API token.

2

What is dry-run mode and how do I enable it?

Dry-run mode simulates all mutation operations (create, update, delete) without making real changes to your Todoist data. Enable it by setting the environment variable `DRYRUN=true` in your MCP server configuration.

3

What common issues may I encounter?

Connection errors often stem from an incorrect or missing `TODOIST_API_TOKEN`. Also verify the configuration file path is correct for your operating system and that the `@greirson/mcp-todoist` package is installed globally.

4

How does the Quick Add tool work?

Quick Add parses natural language text similar to the Todoist app. Use syntax like `due dates`, `#ProjectName` for projects, `@label` for labels, `p1`–`p4` for priority, `//description` at the end, and more.

5

What tools does the Todoist MCP Server provide?

The server offers 19 tools covering tasks, subtasks, bulk operations, projects, sections, labels, comments, reminders, filters, collaboration, user stats, activity logs, backups, notes, shared labels, and utility functions like testing and duplicate detection.

Comments

More Productivity MCP servers

LeadSync MCP

lmoulton

LeadSync's MCP server lets Claude, Cursor, OpenAI's Codex and Gemini CLI manage Facebook and Instagram lead ad delivery in a LeadSync account. Connect lead forms to 30+ CRMs, Google Sheets, email and SMS, map fields, add

CooperBuild

AdamHicksCooperBuild

AI-native operating system for general contractors: estimates, takeoff, bids, pay apps.

Contio MeetingOS

Andrew Ely

Contio MeetingOS is an AI-powered workspace for meeting-driven teams. — from planning to follow-through. It gives you a structured workspace to build agendas, collaborate with participants in real time, capture transcri

crosscode-cli

amsultan2010

Multiplayer coding in the agentic era through an MCP server for real-time codebase sync between your agents.

1

42min

42min

Official 42min MCP server: let Claude, ChatGPT, Cursor or any MCP client manage your meeting scheduling. Check availability, find free slots, book, cancel and reschedule meetings, manage recurring series, secret booking

Advertise