Todoist MCP Server
Provides tools for managing Todoist tasks, projects, and labels, including creating and updating tasks with natural language dates, filtering tasks by various criteria, completing and reopening tasks, and organizing work with projects and labels.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Todoist MCP Server show me my overdue tasks"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Related MCP server: Todoist MCP Server
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.txtAdd 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-mcpLocal clone users
cd ~/.claude/mcp-servers/todoist-mcp
git pull
source .venv/bin/activate
pip install -r requirements.txtAvailable Tools
Tool | Description |
| List all projects |
| Get project details |
| Create a new project |
| List tasks with filters |
| Get task details |
| Create a new task |
| Update a task |
| Mark task complete |
| Reopen a completed task |
| Delete a task |
| List all labels |
| 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
Available Tools
12 toolstodoist_complete_taskAIdempotent
Mark a task as complete.
For recurring tasks, this will close the current occurrence and create the next one.
Args:
params: CompleteTaskInput containing:
- task_id: The task ID to complete
Returns:
Confirmation that the task was completed.
Inputs: params (required). Returns: result
todoist_create_labelB
Create a new label.
Labels help organize tasks across projects. Apply labels to tasks for easy filtering.
Args:
params: CreateLabelInput containing:
- name: Label name
- color: Optional color name
- is_favorite: Whether to mark as favorite
Returns:
Created label details including the new label ID.
Inputs: params (required). Returns: result
todoist_create_projectB
Create a new project in Todoist.
Args:
params: CreateProjectInput containing:
- name: Project name
- parent_id: Optional parent project ID for sub-projects
- color: Optional color name
- is_favorite: Whether to mark as favorite
Returns:
Created project details including the new project ID.
Inputs: params (required). Returns: result
todoist_create_taskA
Create a new task in Todoist.
⚠️ TEMPORAL CHECK: Verify year in due_date matches current year from
system date. LLMs often default to training-data years (2023/2024).
Supports natural language due dates like 'tomorrow', 'next Monday', 'every week'.
Priority 4 is highest (red), priority 1 is lowest.
Args:
params: CreateTaskInput containing:
- content: Task title/content
- description: Optional detailed description
- project_id: Project to add to (defaults to Inbox)
- due_string: Natural language due date
- due_date: Due date in YYYY-MM-DD format
- priority: 1-4 (4 is highest)
- labels: List of label names
- parent_id: Parent task ID for subtasks
Returns:
Created task details including the new task ID.
Inputs: params (required). Returns: result
todoist_delete_taskADestructiveIdempotent
Permanently delete a task.
⚠️ This action cannot be undone. The task will be permanently removed.
Args:
params: DeleteTaskInput containing:
- task_id: The task ID to delete
Returns:
Confirmation that the task was deleted.
Inputs: params (required). Returns: result
todoist_get_projectBRead-onlyIdempotent
Get details of a specific project.
Args:
params: GetProjectInput containing:
- project_id: The project ID
- response_format: 'markdown' or 'json'
Returns:
Project details including name, color, and metadata.
Inputs: params (required). Returns: result
todoist_get_taskARead-onlyIdempotent
Get details of a specific task.
Args:
params: GetTaskInput containing:
- task_id: The task ID
- response_format: 'markdown' or 'json'
Returns:
Full task details including content, description, due date, and labels.
Inputs: params (required). Returns: result
todoist_list_labelsARead-onlyIdempotent
List all personal labels in your Todoist account.
Labels can be applied to tasks for organization and filtering.
Args:
params: ListLabelsInput containing:
- response_format: 'markdown' or 'json'
Returns:
List of labels with their names and colors.
Inputs: params (required). Returns: result
todoist_list_projectsARead-onlyIdempotent
List all projects in your Todoist account.
Returns all projects including personal projects, shared projects, and sub-projects.
Use this to get project IDs for creating tasks in specific projects.
Args:
params: ListProjectsInput containing:
- response_format: 'markdown' or 'json'
Returns:
List of projects with their IDs, names, and metadata.
Inputs: params (required). Returns: result
todoist_list_tasksARead-onlyIdempotent
List tasks from Todoist with optional filters.
Supports filtering by project, label, or using Todoist's filter syntax.
Common filters: 'today', 'tomorrow', 'overdue', 'p1', 'p2', 'no due date',
'due before: tomorrow', '7 days', '@label_name', '#project_name'.
Args:
params: ListTasksInput containing:
- project_id: Filter by project
- label: Filter by label name
- filter: Todoist filter query
- limit: Maximum tasks to return
- response_format: 'markdown' or 'json'
Returns:
List of tasks with their content, due dates, and priorities.
Inputs: params (required). Returns: result
todoist_reopen_taskAIdempotent
Reopen a completed task.
Args:
params: ReopenTaskInput containing:
- task_id: The task ID to reopen
Returns:
Confirmation that the task was reopened.
Inputs: params (required). Returns: result
todoist_update_taskAIdempotent
Update an existing task in Todoist.
Only provided fields will be updated. To clear a due date, use the Todoist app.
Args:
params: UpdateTaskInput containing:
- task_id: The task ID to update
- content: New task title
- description: New description
- due_string: New due date (natural language)
- due_date: New due date (YYYY-MM-DD)
- priority: New priority (1-4)
- labels: New labels (replaces existing)
Returns:
Updated task confirmation.
Inputs: params (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Every tool has a clearly distinct purpose with no ambiguity. Each tool targets a specific resource (task, project, label) and action (create, get, list, update, delete, complete, reopen), making it easy for an agent to select the correct one. The descriptions reinforce these distinctions by specifying exactly what each tool does.
All tool names follow a consistent verb_noun pattern with a 'todoist_' prefix, such as todoist_create_task, todoist_list_projects, and todoist_update_task. This predictable naming convention makes the tool set easy to navigate and understand, with no deviations in style or structure.
With 12 tools, the server is well-scoped for managing tasks, projects, and labels in Todoist. Each tool earns its place by covering essential CRUD operations and lifecycle actions (e.g., complete, reopen), providing a comprehensive yet manageable interface without being overwhelming or sparse.
The tool set offers complete CRUD and lifecycle coverage for tasks (create, get, list, update, delete, complete, reopen), projects (create, get, list), and labels (create, list). There are no obvious gaps; agents can perform all core workflows without dead ends, ensuring effective task management within the domain.
Maintenance
Related MCP Connectors
AI-powered to-do list: add, list, complete and organise tasks across lists from any assistant.
Manage tasks, Focus Zone, notes, projects, and task history from compatible AI assistants.
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Create and manage MeisterTask projects, tasks, and notes from your AI assistant.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Todoist tasks, projects, labels, sections, and comments through natural conversation. Supports comprehensive task operations including creation, updates, completion, and organization with natural language quick-add functionality.-
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Todoist tasks and projects through natural language. Supports comprehensive task management including creating, updating, completing tasks, managing projects, and filtering by various criteria.11GPL 3.0
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to Todoist for comprehensive task management, enabling natural language creation, updating, and organization of tasks, projects, sections, and labels.17 npm3MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Todoist tasks, projects, sections, and labels through natural language, supporting task creation, updates, completion, and intelligent organization of your workflow.17 npmMIT