Todoist AI Assistant

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

---

What does Todoist AI Assistant do?

Todoist AI Assistant is an MCP server that connects AI assistants like Claude Code, Claude Desktop and ChatGPT directly to your Todoist account. It exposes 35 specialized tools covering task management, project organization, label handling, comments and AI-powered productivity features — all accessible through natural language prompts.

Instead of switching between apps, you tell your AI assistant what to do: "Add a task to call the dentist tomorrow at 2pm, high priority." The MCP server handles the Todoist API calls, natural language date parsing, and returns structured results — in under 500ms after the initial cold start.

Without MCP	With Todoist AI Assistant
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
Check overdue tasks one by one	"Analyze my overdue tasks"

One prompt. Zero context switching. Over 35 tools available, including 9 AI-powered features for smart prioritization, focus mode and daily digests.

---

How to connect Todoist to Claude Code (3 minutes)

Step 1: Get your Todoist API Token

Go to Todoist Settings > Integrations > Developer and copy your API token. It's free and takes 10 seconds.

Step 2: Configure on Apify

1. Go to Todoist AI Assistant on Apify
2. Click Try for free
3. Paste your Todoist token in the Input tab
4. Click Save & Build, then Start to validate your token

Step 3: Connect Claude Code

Open Claude Code settings and add a custom MCP server:

Name: Todoist URL:

https://scrapmania--todoist-ai-assistant.apify.actor/mcp?token=YOUR_APIFY_TOKEN

Where to find your Apify token:

• YOUR_APIFY_TOKEN → Apify Console > Settings > Integrations (under "Personal API tokens")

Example: https://scrapmania--todoist-ai-assistant.apify.actor/mcp?token=apify_api_xxxxx

Step 4: Grant permanent permissions

By default, Claude Code asks for approval every time an MCP tool is called. With 35 tools, this gets tedious fast. To allow all Todoist tools permanently, run in Claude Code:

/permissions

Then add mcp__Todoist__* to the Allow list. This grants permanent access to all Todoist tools — no more interruptions.

Note: The prefix mcp__Todoist__ matches the MCP server name you set in Step 3. If you used a different name (e.g., todoist), adjust the pattern accordingly (mcp__todoist__*).

Test it

In Claude Code, type:

"List my Todoist projects"

---

Features

35 Specialized Tools

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

According to the Model Context Protocol specification, MCP servers expose tools that AI assistants can invoke via JSON-RPC. This Actor implements the full MCP protocol with 35 tools — one of the most comprehensive Todoist integrations available for AI assistants.

Natural Language Dates

Works in 4 languages (English, French, Spanish, German):

Input	Result
"tomorrow at 2pm"	2026-02-18T14:00:00
"next Monday"	2026-02-23
"in 3 days"	2026-02-20
"demain matin"	2026-02-18T09:00:00
"lundi prochain"	2026-02-23
"fin du mois"	2026-02-28

AI-Powered Productivity

9 AI features analyze your tasks and provide actionable recommendations:

Feature	What it does
Daily Digest	Personalized morning briefing with priorities
Focus Mode	Top 3-5 tasks to work on right now
Smart Prioritize	Auto-sort by urgency + importance + deadlines
Suggest Priorities	Preview suggestions without applying
Overdue Analysis	Why tasks are late + recommendations
Bottleneck Detection	Find project blockers
Productivity Stats	Statistics by period and project
Batch Organize	Bulk label, move and prioritize tasks
Smart Cleanup	Find obsolete and duplicate tasks

---

What can you ask your AI assistant?

Morning Routine

"Give me my daily digest — what should I focus on today?"

"Show me overdue tasks sorted by priority"

Quick Capture

"Add task: call dentist tomorrow at 2pm, high priority, Personal project"

"Create 3 tasks: buy groceries, review report, email the team — all due this week"

Project Management

"List all P1 tasks in the Work project"

"Analyze bottlenecks in Marketing — what's blocking progress?"

Smart Actions

"Re-prioritize all my tasks based on deadlines and importance"

"Find tasks older than 30 days without due dates — help me clean up"

"I have 2 hours of high energy — what should I focus on?"

---

Alternative Setup: Claude Desktop (Config File)

If you prefer Claude Desktop with a JSON config file:

Add to your claude_desktop_config.json:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

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

Replace YOUR_APIFY_TOKEN with your Apify API token.

Restart Claude Desktop and test with: "List my Todoist projects"

Tip: Claude Desktop will ask you to approve each tool the first time it's used. Click "Allow for this chat" or "Always allow" to avoid repeated permission prompts.

---

Available Tools (35 Total)

Tasks (9 tools)

Tool	Description
todoist_get_tasks	List tasks with filters (project, priority, date, label)
todoist_get_task	Get task by ID
todoist_find_task	Search by name (partial match)
todoist_create_task	Create with natural language dates
todoist_update_task	Modify properties
todoist_complete_task	Mark as done
todoist_reopen_task	Reopen completed task
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 (all or by project)
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 on task or project
todoist_add_comment	Add comment
todoist_update_comment	Edit comment
todoist_delete_comment	Delete comment

AI Features (9 tools)

Tool	Description
todoist_daily_digest	Personalized daily briefing
todoist_focus_mode	Top tasks for right now
todoist_smart_prioritize	Auto-prioritize tasks
todoist_suggest_priorities	Preview priority suggestions
todoist_analyze_overdue	Overdue analysis with recommendations
todoist_identify_bottlenecks	Find project blockers
todoist_get_productivity_stats	Productivity statistics
todoist_batch_organize	Bulk organize tasks
todoist_smart_cleanup	Find obsolete/duplicate tasks

---

What data can you extract?

Each tool returns structured JSON data. Here are the key fields:

Field	Type	Description
id	string	Unique task/project/label ID
content	string	Task name or description
priority	integer	1 (urgent) to 4 (low)
due	object	Due date with date, datetime, isRecurring
projectId	string	Parent project ID
labels	array	List of label names
isCompleted	boolean	Completion status
createdAt	string	ISO 8601 creation timestamp
assigneeId	string	Assigned user ID (shared projects)

Output example

{
  "success": true,
  "tasks": [
    {
      "id": "123456789",
      "content": "Review Q4 report",
      "priority": 1,
      "due": { "date": "2026-02-18", "isRecurring": false },
      "projectId": "987654321",
      "labels": ["work", "urgent"],
      "isCompleted": false
    }
  ],
  "totalCount": 1
}

---

For AI Developers

LLM-Ready Documentation

GET https://scrapmania--todoist-ai-assistant.apify.actor/llms.txt?token=YOUR_APIFY_TOKEN

API Endpoints

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

---

Architecture

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

Security

Your Todoist token is stored server-side on Apify's encrypted infrastructure and is never sent to AI models. The Apify token in the URL authenticates your MCP connection only.

Token	Storage	Exposure
Todoist API	Apify encrypted input	Never visible in AI chat
Apify API	URL parameter	Only for MCP authentication

---

How much does it cost?

Pay-Per-Event Pricing

Operation	Price	Examples
Read	$0.005	get_tasks, get_projects, get_labels
Action	$0.01	create_task, update_project, delete_label
AI	$0.025	smart_prioritize, focus_mode, daily_digest

Cost Estimates

Usage pattern	Monthly cost
Light (50 operations/day)	~$5/month
Medium (150 operations/day)	~$15/month
Heavy (500 operations/day)	~$45/month

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 format and Apify token
"Token API Todoist invalide"	Regenerate token in Todoist Settings > Integrations > Developer
Slow first response	Cold start (~2-3s), then <500ms
Tasks not appearing	Run the Actor once (normal mode) to validate and save your token

---

Frequently Asked Questions

What is a Todoist MCP Server?

An MCP (Model Context Protocol) server acts as a bridge between AI assistants and external services. The Todoist MCP Server exposes 35 tools that allow Claude, ChatGPT, and other AI assistants to read and manage your Todoist tasks, projects, labels and comments through natural language commands.

How do I connect Todoist to Claude Code?

Three steps: (1) copy your Todoist API token from Todoist Settings, (2) paste it in the Actor's input on Apify and run once to validate, (3) add the Standby URL as a custom MCP server in Claude Code settings. The full setup takes about 3 minutes.

Is my Todoist data secure?

Yes. Your Todoist API token is stored on Apify's encrypted infrastructure and is never exposed to AI models. The MCP server runs in Apify's secure sandbox with limitedPermissions enabled, meaning it only accesses your Todoist data — nothing else. All communication uses HTTPS encryption.

How much does it cost to use?

The Actor uses pay-per-event pricing: $0.005 per read operation, $0.01 per write operation, and $0.025 per AI feature. For typical daily use (checking tasks, creating a few tasks, running a daily digest), expect around $5-15/month. A free tier is available for testing.

What AI features are available?

9 AI-powered tools: Daily Digest (morning briefing), Focus Mode (top tasks for right now), Smart Prioritize (auto-sort by urgency), Suggest Priorities (preview without applying), Overdue Analysis, Bottleneck Detection, Productivity Stats, Batch Organize, and Smart Cleanup (find duplicates and obsolete tasks).

Does it work with ChatGPT, Cursor or VS Code?

Yes. Any MCP-compatible client can connect. For Claude Desktop, add the Standby URL as a custom connector. For Cursor and VS Code, use the @anthropic/mcp-proxy package in your MCP configuration. ChatGPT supports MCP servers through its plugin system.

Can I use natural language dates?

Yes. The server parses natural language dates in 4 languages: English, French, Spanish and German. Examples: "tomorrow at 2pm", "demain matin", "next Monday", "fin du mois", "in 3 days". ISO format (2026-12-25) is also supported.

What happens if my Todoist token expires?

Todoist personal API tokens do not expire unless you manually revoke them. If you regenerate your token in Todoist Settings, you need to update the Actor input on Apify and run once to re-validate. The MCP connection itself (Apify Standby URL) does not change.

How many tools are available?

35 tools organized in 6 categories: Tasks (9), Projects (5), Sections (4), Labels (4), Comments (4), and AI Features (9). Each tool is designed for a specific operation, from simple reads to complex AI-powered analysis.

Can I use it in French, Spanish or German?

Yes. Set the defaultLanguage parameter in the Actor input to fr, es, or de. This affects AI-generated analysis text, recommendations, and natural language date parsing. Task content remains in whatever language you write it in.

---

Related Actors

• LoL Esports MCP Server — MCP server for League of Legends esports data
• TFT MCP Server — MCP server for Teamfight Tactics player analytics

---

Links

• Apify Store: apify.com/scrapmania/todoist-ai-assistant
• Todoist API: developer.todoist.com
• MCP Protocol: modelcontextprotocol.io
• Claude Code: claude.ai/download
• Issues & Support: GitHub Issues

---

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