
Todoist Mcp
Connects Claude directly to your Todoist account via the REST API. You get the full suite of task operations: create, update, complete, search, and filter tasks across projects. Supports natural language date parsing ("next Monday at 2pm"), priority levels, labels, and subtask creation. Includes built-in rate limiting to respect Todoist's 450 requests per 15 minutes cap. Requires a Todoist API token from your integration settings. Useful when you want Claude to manage your actual task list instead of just suggesting what to do, whether that's parsing meeting notes into action items or triaging your inbox based on conversation.
- tools
- 7
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Jan 4, 2026
Tools
7 toolsPublic tool metadata for what this MCP can expose to an agent.
todoist_create_taskCreate a new task in Todoist with optional project, due date, priority, labels, and parent task for subtasks.
Create a new task in Todoist with optional project, due date, priority, labels, and parent task for subtasks.
No parameter schema in public metadata yet.
todoist_list_tasksList active tasks with optional filters for project, section, label, or custom Todoist filter.
List active tasks with optional filters for project, section, label, or custom Todoist filter.
No parameter schema in public metadata yet.
todoist_get_taskGet detailed information about a specific task including all metadata.
Get detailed information about a specific task including all metadata.
No parameter schema in public metadata yet.
todoist_update_taskUpdate an existing task with new content, description, due date, priority, or labels.
Update an existing task with new content, description, due date, priority, or labels.
No parameter schema in public metadata yet.
todoist_complete_taskMark a task as completed.
Mark a task as completed.
No parameter schema in public metadata yet.
todoist_list_projectsList all projects in Todoist, including inbox and shared projects.
List all projects in Todoist, including inbox and shared projects.
No parameter schema in public metadata yet.
todoist_search_tasksSearch for tasks by text in their content or description.
Search for tasks by text in their content or description.
No parameter schema in public metadata yet.
Sponsors
Configuration
YOUR_API_KEY*secretYour API key for the service
Readme
Todoist MCP Server
A Model Context Protocol (MCP) server for Todoist task management, enabling Claude to interact with your Todoist tasks and projects.
Features
- β Create, read, update, and complete tasks
- π List tasks with advanced filtering
- π Search tasks by text content
- π Manage projects
- π·οΈ Support for labels and priorities
- π Natural language date parsing
- β‘ Rate limiting to stay within API limits
- π‘οΈ Comprehensive error handling
Installation
Prerequisites
- Node.js >= 18.0.0
- npm or yarn
- A Todoist account with an API token
From Source
# Clone the repository
git clone <your-repo-url>
cd todoist-mcp
# Install dependencies
npm install
# Build the project
npm run build
Configuration
1. Get Your Todoist API Token
- Go to Todoist Integrations Settings
- Scroll down to "API token" section
- Copy your personal API token
2. Set Up Environment Variables
Create a .env file in the project root:
cp .env.example .env
Edit .env and add your Todoist API token:
TODOIST_API_TOKEN=your_actual_token_here
LOG_LEVEL=error
Details
- Repository
- github.com/ecfaria/todoist-mcp
- Category
- Productivity & Office
- Package
@ecfaria/todoist-mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active