Todoist MCP Server

AI-Powered Task Management for Claude, ChatGPT & MCP-Compatible Assistants

LICENSE

---

Why This Actor?

Without MCP	With Todoist MCP
Open Todoist app	Just tell Claude
Navigate to project	"Add task to Work project"
Click "Add task"	Done in 2 seconds
Fill in details	Natural language dates
Set priority manually	AI suggests priorities

One prompt. Zero context switching.

---

Quick Start (5 minutes)

1. Get Todoist token    → todoist.com/app/settings/integrations/developer
2. Fork Actor on Apify  → apify.com/scrapmania/todoist-mcp-server
3. Add token as secret  → Actor Settings > Environment Variables
4. Enable Standby mode  → Actor Settings > Standby > Enable
5. Connect Claude       → Settings > Connectors > Add Custom

Your Standby URL:

https://YOUR-USERNAME--todoist-mcp-server.apify.actor/mcp?token=YOUR_APIFY_TOKEN

---

Highlights

36 Specialized Tools

Category	Tools	Examples
Tasks	9	create, complete, move, find
Projects	5	create, update, delete
Sections	4	organize project structure
Labels	4	tag and filter tasks
Comments	4	add notes to tasks
AI Features	10	smart prioritize, focus mode

Natural Language Dates

Works in English and French:

"tomorrow at 2pm"        → 2024-01-09T14:00:00
"next Monday"            → 2024-01-15
"in 3 days"              → 2024-01-11
"end of month"           → 2024-01-31
"demain matin"           → 2024-01-09T09:00:00
"lundi prochain"         → 2024-01-15

AI-Powered Productivity

Feature	What it does
Daily Digest	Personalized morning briefing
Focus Mode	Top 3-5 tasks for right now
Smart Prioritize	Auto-sort by urgency + importance
Overdue Analysis	Why tasks are late + recommendations
Bottleneck Detection	Find project blockers
Smart Cleanup	Remove obsolete/duplicate tasks

---

Example Prompts

Morning Routine

"Give me my daily digest"
"What should I focus on today?"
"Show me overdue tasks"

Quick Capture

"Add task: call dentist tomorrow at 2pm, high priority"
"Create tasks: buy groceries, review report, email team"

Project Management

"List all P1 tasks in Website Redesign"
"Move completed tasks to Archive section"
"Analyze bottlenecks in Marketing project"

Smart Actions

"Re-prioritize my tasks based on deadlines"
"Find tasks older than 30 days without due dates"
"What's blocking the Product Launch project?"

---

Installation Guide

Prerequisites

• Todoist account (free or Pro)
• Apify account (free tier works)
• Claude Desktop or MCP-compatible client

Step 1: Get Todoist API Token

1. Open Todoist Settings
2. Scroll to API token
3. Copy the token

Step 2: Configure on Apify

1. Go to Todoist MCP Server on Apify
2. Click Try for free
3. Go to Settings > Environment variables
4. Add:

   Name	Value	Secret
   TODOIST_API_TOKEN	your-token	Yes

5. Build the Actor

Step 3: Enable Standby Mode

1. Go to Settings > Standby
2. Configure:

   Setting	Value
   Idle timeout	3600 seconds
   Memory	256 MB

3. Copy your Standby URL

Step 4: Connect Claude Desktop

Option A: Custom Connector (Recommended)

1. Claude Desktop > Settings > Connectors
2. Add Custom Connector
3. URL: https://YOUR-USERNAME--todoist-mcp-server.apify.actor/mcp?token=YOUR_APIFY_TOKEN

Option B: Config File

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-proxy", "https://YOUR-USERNAME--todoist-mcp-server.apify.actor/mcp?token=YOUR_APIFY_TOKEN"]
    }
  }
}

Step 5: Test

In Claude Desktop:

"List my Todoist projects"

---

Available Tools (36 Total)

Tasks (9 tools)

Tool	Description
todoist_get_tasks	List tasks with filters
todoist_get_task	Get task by ID
todoist_find_task	Search by name
todoist_create_task	Create with natural language dates
todoist_update_task	Modify properties
todoist_complete_task	Mark as done
todoist_reopen_task	Reopen completed
todoist_delete_task	Delete task
todoist_move_task	Move to project/section

Projects (5 tools)

Tool	Description
todoist_get_projects	List all projects
todoist_get_project	Get project details
todoist_create_project	Create new project
todoist_update_project	Modify project
todoist_delete_project	Delete project

Sections (4 tools)

Tool	Description
todoist_get_sections	List sections
todoist_create_section	Create in project
todoist_update_section	Rename section
todoist_delete_section	Delete section

Labels (4 tools)

Tool	Description
todoist_get_labels	List all labels
todoist_create_label	Create label
todoist_update_label	Modify label
todoist_delete_label	Delete label

Comments (4 tools)

Tool	Description
todoist_get_comments	Get comments
todoist_add_comment	Add comment
todoist_update_comment	Edit comment
todoist_delete_comment	Delete comment

AI Features (10 tools)

Tool	Description
todoist_daily_digest	Morning briefing
todoist_focus_mode	Top tasks for now
todoist_smart_prioritize	Auto-prioritize
todoist_suggest_priorities	Preview suggestions
todoist_analyze_overdue	Overdue analysis
todoist_identify_bottlenecks	Find blockers
todoist_get_productivity_stats	Statistics
todoist_batch_organize	Bulk operations
todoist_smart_cleanup	Find obsolete tasks

---

For AI Developers

LLM-Ready Documentation

Index our documentation in your IDE for AI context:

GET /llms.txt

URL:

https://YOUR-USERNAME--todoist-mcp-server.apify.actor/llms.txt?token=YOUR_APIFY_TOKEN

Cursor Setup:

1. Settings > Indexing & Docs > Add Docs
2. Add the URL above

API Endpoints

Endpoint	Method	Description
/mcp	POST	MCP JSON-RPC endpoint
/mcp	GET	SSE streaming
/health	GET	Health check
/llms.txt	GET	LLM documentation
/	GET	Server info

---

Architecture

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Claude Desktop │────>│  Apify Standby  │────>│   Todoist API   │
│   (MCP Client)  │<────│   (MCP Server)  │<────│                 │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                       │                       │
        │   JSON-RPC/HTTP       │    REST API           │
        │   + Apify Token       │    + Todoist Token    │
        └───────────────────────┴───────────────────────┘

Security

Token	Storage	Exposure
Todoist API	Apify encrypted env var	Never in AI chat
Apify API	URL parameter	Only for auth

---

Pricing

Pay-Per-Event

Operation	Price	Examples
Read	$0.005	get_tasks, get_projects
Write	$0.01	create_task, update_project
AI	$0.025	smart_prioritize, focus_mode

Apify Compute

• Standby mode: ~$0.25/hour when active
• Typical usage: $1-5/month
• Free tier: Available for testing

---

Troubleshooting

Problem	Solution
"Server disconnected"	Check Standby URL and Apify token
"Token API Todoist requis"	Add TODOIST_API_TOKEN env var
Slow first response	Cold start (~2-3s), then <500ms
Tasks not appearing	Verify Todoist token validity

---

Links

• Apify Store: apify.com/scrapmania/todoist-mcp-server
• Todoist API: developer.todoist.com
• MCP Protocol: modelcontextprotocol.io
• Claude Desktop: claude.ai/download

---

License

MIT License - Use freely in personal and commercial projects.

---

Keywords

MCP Server Model Context Protocol Todoist API Claude Desktop AI Task Management Productivity Automation Apify Actor ChatGPT Integration Natural Language Tasks Smart Prioritization

---

Built for productivity enthusiasts who want AI to handle the busywork.