Todoist MCP Server

Connect your AI agent to your task management system. Create tasks from conversations, structure them by priority and deadline, plan your day, and track progress, all through natural language.

MCP Server·4 sections·1 min read

productivityworkflow

Install Prompt

Paste this into Claude Code to set it up:

I want to add the Todoist MCP Server to my Claude Code setup.

IMPORTANT: Never use Read/Edit tools on ~/.claude.json. Use jq via Bash instead.

Todoist offers an official HTTP MCP integration that requires no API token and handles authentication via OAuth.

Run this command to add the MCP server:
```bash
jq '.mcpServers["todoist"] = {"type": "http", "url": "https://ai.todoist.net/mcp/"}' ~/.claude.json > /tmp/claude-json-tmp && mv /tmp/claude-json-tmp ~/.claude.json
```

After adding, restart Claude Code. On first connection, your browser will open a Todoist OAuth prompt. Grant the permissions and you are ready to go. The connection persists across sessions.

01What It Does

Where all your work lands

Every other MCP in your ecosystem generates work. GitHub creates code tasks. Notion surfaces documentation gaps. Calendar reveals scheduling conflicts. Todoist is where all of that work lands, gets prioritized, and gets tracked. Without it, the agent can observe your world but cannot act on it in a structured way.

📝

Task ManagementCreate, update, and complete tasks with priority, due dates, labels, and descriptions. Search by keyword or filter.

📁

Project OrganizationCreate projects with sections for structured organization. Get full project overviews with task hierarchies.

📊

Activity TrackingQuery completion history, track what was accomplished over any time period, and get full account overviews.

02Real Scenarios

"Plan my day"

The agent pulls today's tasks plus overdue items, groups them by project, checks priorities, and creates a structured plan. With Calendar MCP, it overlays against your schedule.

"Break down this feature into tasks"

You describe the feature. The agent creates a project, adds sections (Design, Implementation, Testing), and populates each with prioritized tasks and due dates.

"What did I accomplish this week?"

The agent queries completed tasks from the past seven days, groups by project, and generates a summary. Perfect for standups and weekly reviews.

"Create action items from this meeting"

From meeting notes, the agent extracts action items and creates tasks with appropriate priorities, due dates, and assignments.

03Setup

Get Your API Token

Open Todoist, go to Settings > Integrations > Developer, and copy your API token.

Add to Config

Add the STDIO config to ~/.claude.json with your token as an environment variable.

Restart and Go

Restart Claude Code. The server connects immediately; no OAuth browser flow needed.

# Add to ~/.claude.json under mcpServers
"todoist": {
  "type": "stdio",
  "command": "npx",
  "args": ["-y", "@anthropic/todoist-mcp"],
  "env": { "TODOIST_API_TOKEN": "your-token" }
}

04Works Well With

📅

Google Workspace MCPCalendar for when, Todoist for what. The agent knows your tasks and your availability, so it can suggest realistic schedules and flag overcommitment.

🐙

GitHub MCPCreate Todoist tasks from GitHub issues. Mark tasks complete when PRs merge. Keep your code workflow and task board in sync.

📝

Notion MCPDocumentation provides context for tasks. The agent can reference Notion pages when creating tasks and link meeting notes to action items.

🔎

Perplexity MCPResearch a topic, then create structured tasks based on findings. Turns investigation into executable next steps.