Todoist Python MCP Server

by Johnxjp

Integrations

  • Provides tools for task management in Todoist, including creating tasks with various attributes, retrieving tasks with filtering options, updating task details, marking tasks as complete, and deleting tasks.

Todoist MCP Server

A Model Context Protocol (MCP) server that allows clients like Claude to interact with Todoist, enabling task management capabilities through natural language. The server acts as an intermediary between clients and the Todoist API, handling authentication, data transformation, and command processing. This is a Python version

Features

  • Task Creation: Create new tasks with required content and optional attributes
  • Task Retrieval: Get task by ID or list tasks with filtering options
  • Task Management: Update task attributes, mark tasks as complete, delete tasks

Prerequisites

  • Python 3.12
  • uv
  • A Todoist account and API token

How to get Todoist API Token

  1. Login to your Todoist account
  2. Go to User Settings -> Integrations -> Developer
  3. Copy API token

Usage with Claude Desktop

Run via UVX (without cloning)

You can run the server directly from GitHub using UVX:

uvx --from https://github.com/Johnxjp/todoist-mcp-python.git mcp-server-todoist

Then add this configuration to your Claude settings:

{ "mcpServers": { "todoist-server": { "command": "uvx", "args": [ "--from", "https://github.com/Johnxjp/todoist-mcp-python.git", "mcp-server-todoist" ], "env": { "TODOIST_API_TOKEN": "YOUR_API_TOKEN" } } } }

Run from cloned repository

If you prefer to clone the repository, use these commands:

git clone git@github.com:Johnxjp/todoist-mcp-python.git

Then add to your Claude config file:

{ "mcpServers": { "todoist-server": { "command": "uv", "args": [ "run", "--with", "mcp[cli]", "--with", "todoist_api_python", "mcp", "run", "/full/path/to/todoist_server.py" ], "env": { "TODOIST_API_TOKEN": "YOUR_API_TOKEN" } } } }

Available Tools

The server provides the following tools for Claude to use:

  1. create_task: Create a new task in Todoist
    • Required: content (title of the task)
    • Optional:
      • description,
      • due_date,
      • priority,
      • project_id,
      • section_id,
      • labels
  2. get_tasks: Get a list of tasks and Ids from Todoist with various filters
    • Optional:
      • project_id,
      • project_name,
      • task_name,
      • priority,
      • labels,
      • is_overdue,
      • limit
  3. update_task: Update an existing task by searching for it by name
    • Required: task_id
    • Optional:
      • content,
      • description,
      • labels,
      • priority,
      • due_date (YYYY-MM-DD),
      • deadline_date (YYYY-MM-DD)
  4. delete_task: Delete a task by searching for it by name
    • Required: task_id
  5. complete_task: Mark a task as complete by searching for it by name
    • Required: task_id

Example Interactions

Here are some examples of how Claude can interact with Todoist through this MCP server:

  • "Add a task to buy groceries"
  • "Show me all my urgent tasks"
  • "What tasks are due today?"
  • "Mark the laundry task as done"
  • "Change the priority of my dentist appointment to urgent"

Security Considerations

  • The server securely handles your Todoist API token through environment variables
  • Never share your .env file or expose your API token
  • The server runs locally and communicates only with the Todoist API

License

MIT License

Acknowledgements

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Profile server that enables Claude to interact with Todoist, allowing users to create, retrieve, update, and manage tasks through natural language commands.

  1. Features
    1. Prerequisites
      1. How to get Todoist API Token
    2. Usage with Claude Desktop
      1. Run via UVX (without cloning)
        1. Run from cloned repository
          1. Available Tools
            1. Example Interactions
              1. Security Considerations
                1. License
                  1. Acknowledgements

                    Related MCP Servers

                    • A
                      security
                      A
                      license
                      A
                      quality
                      An MCP server that integrates Claude with Todoist, enabling natural language task management including creating, updating, completing, and deleting tasks.
                      Last updated -
                      5
                      245
                      153
                      JavaScript
                      MIT License
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol server that integrates with Notion's API to manage personal todo lists, allowing users to view, add, and update tasks directly from Claude.
                      Last updated -
                      3
                      Python
                      MIT License
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol server that bridges Claude with Google Tasks, allowing users to manage task lists and tasks directly through Claude interface.
                      Last updated -
                      5
                      TypeScript
                      MIT License
                      • Apple
                    • A
                      security
                      F
                      license
                      A
                      quality
                      A Model Context Protocol service for Claude that enables natural language interaction with Microsoft Todo tasks, including viewing task lists, creating tasks, and managing checklist items.
                      Last updated -
                      13
                      111
                      3
                      TypeScript
                      • Apple
                      • Linux

                    View all related MCP servers

                    ID: k04unr21co