Skip to main content
Glama

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

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

  1. Open Todoist (web or app)

  2. Go to Settings → Integrations → Developer

  3. 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 today

  • tomorrow - Tasks due tomorrow

  • overdue - Overdue tasks

  • p1, p2, p3, p4 - Filter by priority

  • no due date - Tasks without due dates

  • 7 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 tools
todoist_complete_taskA
Idempotent
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_taskA
DestructiveIdempotent
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_projectB
Read-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_taskA
Read-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_labelsA
Read-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_projectsA
Read-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_tasksA
Read-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_taskA
Idempotent
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_taskA
Idempotent
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

    A4.1/5.0

    Scored across 12 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers