ecfaria avatar

Todoist Mcp

ecfaria/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 tools

Public 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*secret

Your 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

  1. Go to Todoist Integrations Settings
  2. Scroll down to "API token" section
  3. 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

View the full README on GitHub

Details

Repository
github.com/ecfaria/todoist-mcp
Category
Productivity & Office
Package
@ecfaria/todoist-mcp-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Productivity & Office MCP servers

View all
1greirson avatarTodoistgreirson/mcp-todoistMCP server that connects Claude to Todoist for natural language task and project management with bulk operations240stars
2ankimcp avatarAnkiMCP Serverankimcp/anki-mcp-server-addonAnki addon that exposes your flashcard collection to AI assistants via a local MCP server.100stars
3henilcalagiya avatarMcp Apple Noteshenilcalagiya/mcp-apple-notesMCP server for Apple Notes integration using AppleScript with full CRUD operations51stars
4rog0x avatarTaskrog0x/mcp-task-toolsTodo, priority, estimation, burndown for AI agents0stars
5mag-cie avatarMcp Microsoft Todomag-cie/mcp-microsoft-todoMCP server for Microsoft To Do via Microsoft Graph. MSAL device code flow, no client secret needed.3stars
6doist avatarTodoistdoist/todoist-mcpOfficial Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.563stars