Todoist MCP Server

MCPOpen SourceMIT34.9

by mikemc • Workflow & Task Management

A Python MCP server that lets agents access and manipulate Todoist projects, sections, tasks, and comments via the Todoist REST API.

Example Use Cases

1
Query and summarize completed or outstanding tasks (e.g., "tasks completed in the last 7 days") from Todoist for reporting or status updates.
2
Create, update, move, complete, uncomplete, or delete tasks, projects, sections, and comments programmatically as part of automated workflows.
3
Integrate a local LLM or Claude/Goose-based assistant with Todoist to enable conversational task management and natural-language-driven task operations.

Description

This is an open-source Python implementation of a Todoist MCP server that uses the Todoist Python API and requires a Todoist API token. It integrates with Claude Desktop and local LLM tooling like Goose to enable conversational and programmatic task management. The server exposes many tools for working with projects, sections, tasks, and comments (create/update/delete/move/complete/etc.), making it useful for automating productivity workflows. It's intended as an unofficial, user-maintained adapter for connecting agents and local LLMs to Todoist.

Capabilities(3 total)

Tools (3)

create_task

Create a new task in Todoist. Priorities don't map directly to Todoist priorities, but are mapped as follows: 1 = low 2 = medium 3 = high 4 = urgent This is done to map better to how people think about priorities. Args: content: The task content/title (required) description: Task description (optional) project_name: Project name to add task to due_string: Due date in natural language like "tomorrow", "next monday" (optional) priority: Priority level 1-4 (1=low, 2=medium, 3=high, 4=urgent) labels: List of label names to add to the task (optional) Returns: Dict containing the created task details or error message

content:string*description:stringproject_name:stringdue_string:stringpriority:integerlabels:array

list_active_tasks

List tasks from Todoist Args: project_name: Filter tasks by project name (alternative to project_id) filter_string: Todoist filter string like "today", "overdue", "p1" (optional) limit: Maximum number of tasks to return (default 50) Returns: Dict containing list of tasks or error message

project_id:stringproject_name:stringfilter_string:stringlimit:integer

list_completed_tasks

List completed tasks from Todoist within a timespan. Default is last 24 hours. Prefer not to provide `since` and `until` if you want to pull tasks from the last 24 hours. Args: project_name: Filter tasks by project name (optional) since: Start date in ISO format (YYYY-MM-DD) in the user's timezone (optional) until: End date in ISO format (YYYY-MM-DD) in the user's timezone (optional) limit: Maximum number of tasks to return (default 30, max 200) Returns: Dict containing list of completed tasks or error message

project_name:stringsince:stringuntil:stringlimit:integer

Quick Actions

View on GitHub

Security

Scanned 3 month(s) ago

Risk Level

MINIMAL

Read-only data retrieval, no side effects

Trust Score

C63/100

10/17 checks passed

Scores are informational only and provided “as is” without warranty. AgentHotspot assumes no liability for actions taken based on these ratings.

Quick Stats

Service TypeMCP

Pricing ModelFree

Capabilities3 Tools / 0 Prompts / 0 Resources

Ownermikemc

CategoryWorkflow & Task Management

DependenciesStandalone

Set Your Username