Todoist MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
npm install
npm run build
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add -e "TODOIST_API_TOKEN=${TODOIST_API_TOKEN}" todoist-2642 -- node "<FULL_PATH_TO_TODOIST_MCP>/dist/index.js"

Replace <FULL_PATH_TO_TODOIST_MCP>/dist/index.js with the actual folder you prepared in step 1.

Required:TODOIST_API_TOKEN
README.md

Comprehensive task management through Todoist for AI assistants.

Todoist MCP Server

An MCP (Model Context Protocol) server that provides comprehensive task management through Todoist. This enables AI assistants like Claude to create, manage, and organize tasks using natural language.

Features

Tools (21 total)

Tool Description
list_tasks List tasks with filtering (by project, priority, due date, etc.)
get_task Get detailed task info including comments and subtasks
create_task Create tasks with natural language due dates
update_task Update task content, due date, priority, labels
complete_task Mark tasks complete (handles recurring)
uncomplete_task Reopen completed tasks
delete_task Permanently delete tasks
move_task Move tasks between projects/sections
list_projects List all projects
create_project Create new projects
update_project Update project name, color, view style
delete_project Permanently delete projects
list_sections List sections within projects
create_section Create sections
update_section Rename or collapse/expand sections
move_section Move sections between projects
delete_section Permanently delete sections
list_labels List all labels
create_label Create new labels
update_label Update label name, color, order
delete_label Permanently delete labels
add_comment Add comments to tasks
get_productivity_stats Get completion statistics
quick_add Natural language task entry

Resources

Resource Description
todoist://today Today's tasks including overdue
todoist://upcoming Tasks due in the next 7 days
todoist://overdue All overdue tasks
todoist://projects Project overview with task counts
todoist://labels Labels and usage counts

Prompts

Prompt Description
daily_planning Morning planning workflow
weekly_review GTD-style weekly review
quick_capture Rapid multi-task capture
task_breakdown Break large tasks into subtasks

Setup

1. Get Your Todoist API Token

  1. Go to https://todoist.com/app/settings/integrations/developer
  2. Scroll to "API token"
  3. Copy your token

2. Install Dependencies

cd todoist-mcp
npm install

3. Build

npm run build

4. Add to Claude Code

claude mcp add --transport stdio todoist \
  --env TODOIST_API_TOKEN=your_token_here \
  -- node /path/to/todoist-mcp/dist/index.js

Or add manually to your Claude Code configuration:

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

5. Verify Connection

In Claude Code, type /mcp to check the server is connected.

Usage Examples

Create a Task

"Add a task to review the budget report by Friday"

The AI will use create_task with natural language due date parsing.

View Today's Tasks

"What do I need to do today?"

Uses the todoist://today resource or list_tasks with dueToday: true.

Daily Planning

"Let's do my daily planning"

Invokes the daily_planning prompt for a guided planning session.

Quick Capture

"Add these tasks: call dentist tomorrow, review PR by EOD, update docs"

Uses quick_add or create_task for natural language entry.

Initialize GTD Structure (One-Time Setup)

Run the setup script to create a GTD-inspired structure:

TODOIST_API_TOKEN=your_token npx tsx scripts/setup-gtd-structure.ts

This creates:

  • Projects: Work, Personal (with sub-projects), Recurring, Someday/Maybe, Reference
  • Labels: Context (@computer, @phone), Energy (@high-energy), Time (@5min, @deep-work), Status (@waiting-for)

Natural Language Due Dates

Todoist supports flexible date parsing:

Input Result
today Today
tomorrow Tomorrow
tomorrow at 2pm Tomorrow at 2:00 PM
next monday Next Monday
in 3 days 3 days from now
jan 15 January 15
every day Daily recurring
every monday at 9am Weekly on Monday at 9 AM
every weekday Monday through Friday

Priority Mapping

API Value Display Color
4 P1 (highest) Red
3 P2 Orange
2 P3 Yellow
1 P4 (default) None

Rate Limiting

The server implements rate limiting to stay within Todoist's API limits:

  • Limit: 450 requests per 15 minutes
  • Caching: Projects and labels are cached for 5 minutes

Development

Run in Development Mode

npm run dev

This runs TypeScript in watch mode.

Test with MCP Inspector

npm run inspect

Opens the MCP Inspector for testing tools and resources.

Project St

Tools (6)

list_tasksList tasks with filtering by project, priority, or due date.
create_taskCreate tasks with natural language due dates.
complete_taskMark tasks complete, including recurring tasks.
list_projectsList all projects.
add_commentAdd comments to tasks.
quick_addNatural language task entry.

Environment Variables

TODOIST_API_TOKENrequiredYour Todoist API token from developer settings.

Configuration

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

Try it

→Add a task to review the budget report by Friday
→What do I need to do today?
→Let's do my daily planning
→Add these tasks: call dentist tomorrow, review PR by EOD, update docs

Frequently Asked Questions

What are the key features of Todoist MCP Server?

Comprehensive task management including creation, updates, and deletion. Project and section organization with support for nested structures. Natural language due date parsing for task scheduling. Productivity tracking and statistics reporting. Built-in support for GTD-style workflows and daily planning.

What can I use Todoist MCP Server for?

Automating daily planning sessions by pulling today's tasks and overdue items. Rapidly capturing multiple tasks from a meeting transcript using natural language. Managing complex projects by moving tasks and sections between different project boards. Performing a GTD-style weekly review to organize and prioritize upcoming work.

How do I install Todoist MCP Server?

Install Todoist MCP Server by running: npm install && npm run build

What MCP clients work with Todoist MCP Server?

Todoist MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Todoist MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all ai-tools servers →

Related MCP Servers

Skill Seekers
The data layer for AI systems.
ai-tools11.1K stars
Context Mode
The other half of the context problem.
ai-tools5.6K stars
Semiotic
A React data visualization library designed for AI-assisted development.
ai-tools2.6K stars
RocketRide
Self-hosted, open-source AI pipeline platform for MCP tools
ai-tools1.6K stars
Context+
Semantic Intelligence for Large-Scale Engineering.
ai-tools1.5K stars
ShipSwift
AI-native SwiftUI component library — production-ready code for LLMs
ai-tools1.3K stars