Todoist MCP Server
MCP server for Todoist task management. Provides 12 tools for tasks, projects, and labels.
Features
- Tasks: Create, list, update, complete, reopen, and delete tasks
- Projects: List and create projects, including sub-projects
- Labels: List and create labels for task organization
- Filters: Support for Todoist filter syntax (
today,overdue,p1, etc.) - Natural language dates: Use
tomorrow,next Monday,every week, etc.
Installation
Option 1: uvx (Recommended)
Zero-install method using uv. Add to ~/.claude.json:
{
"mcpServers": {
"todoist": {
"command": "uvx",
"args": ["--from", "git+https://github.com/IAMSamuelRodda/todoist-mcp", "todoist-mcp"],
"env": {
"TODOIST_API_TOKEN": "your-api-token"
}
}
}
}
Option 2: Local Clone
mkdir -p ~/.claude/mcp-servers
git clone https://github.com/IAMSamuelRodda/todoist-mcp.git ~/.claude/mcp-servers/todoist-mcp
cd ~/.claude/mcp-servers/todoist-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
Add to ~/.claude.json:
{
"mcpServers": {
"todoist": {
"command": "~/.claude/mcp-servers/todoist-mcp/.venv/bin/python",
"args": ["~/.claude/mcp-servers/todoist-mcp/todoist_mcp.py"],
"env": {
"TODOIST_API_TOKEN": "your-api-token"
}
}
}
}
Get Your API Token
- Open Todoist (web or app)
- Go to Settings → Integrations → Developer
- Copy your API token
Updating
uvx users
uv cache clean todoist-mcp
Local clone users
cd ~/.claude/mcp-servers/todoist-mcp
git pull
source .venv/bin/activate
pip install -r requirements.txt
Available Tools
| Tool | Description |
|---|---|
todoist_list_projects | List all projects |
todoist_get_project | Get project details |
todoist_create_project | Create a new project |
todoist_list_tasks | List tasks with filters |
todoist_get_task | Get task details |
todoist_create_task | Create a new task |
todoist_update_task | Update a task |
todoist_complete_task | Mark task complete |
todoist_reopen_task | Reopen a completed task |
todoist_delete_task | Delete a task |
todoist_list_labels | List all labels |
todoist_create_label | Create a new label |
Usage Examples
Once configured, you can ask Claude:
- "Show me my tasks for today"
- "Create a task to review the quarterly report due next Friday"
- "List all my projects"
- "Mark task 123456789 as complete"
- "What are my overdue tasks?"
- "Create a high-priority task in my Work project"
Filter Syntax
The todoist_list_tasks tool supports Todoist's filter syntax:
today- Tasks due todaytomorrow- Tasks due tomorrowoverdue- Overdue tasksp1,p2,p3,p4- Filter by priorityno due date- Tasks without due dates7 days- Tasks due in the next 7 days@label_name- Tasks with specific label#project_name- Tasks in specific project
License
MIT