Skip to main content
Glama

Todoist MCP Server

by mikemc

Todoist MCP Server (Python)

A Todoist MCP server written in Python, using the Todoist Python API. I first created the server by using Claude to translate this TypeScript Todoist MCP server to Python. I'm gradually changing and adding functionality to suit my workflow as I experiment with using Claude to help with task management.

Installation

Prerequisites

Getting a Todoist API Token

  1. Log in to your Todoist account
  2. Go to Settings → Integrations
  3. Find your API token under "Developer"

Configuration with Claude Desktop

Add the MCP server to your claude_desktop_config.json,

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

Or, to run from a local copy,

{ "mcpServers": { "todoist": { "command": "uvx", "args": [ "--from", "/absolute/path/to/todoist-mcp-server", "todoist-mcp" ], "env": { "TODOIST_API_TOKEN": "your_todoist_api_token" } } } }

Configuration with Goose (and a local LLM)

You can use Goose and a local LLM provider: LM Studio or Ollama.

Configure the LLM you want Goose to use:

$ goose configure

This command will ask you whether you want to use a local model or a cloud hosted model. Ensure your model provider is running your model first. Specify the address of the model API, and the model name. Many locally deployed LLMs use a format compatible with Ollama, so for both LM Studio or Ollama LLMs, select Ollama.

◇ Which model provider should we use? │ Ollama │ ◇ Provider Ollama requires OLLAMA_HOST, please enter a value │ localhost:1234 │ ◇ Model fetch complete │ ◇ Enter a model from that provider: │ phi-4

Then run the same command again to configure the Todoist MCP:

$ goose configure

This time it will ask about extensions:

◇ What would you like to configure? │ Add Extension │ ◇ What type of extension would you like to add? │ Command-line Extension │ ◇ What would you like to call this extension? │ todoist │ ◇ What command should be run? │ uvx git+https://github.com/mikemc/todoist-mcp-server │ ◇ Please set the timeout for this tool (in secs): │ 60 │ ◇ Would you like to add a description? │ No │ ◇ Would you like to add environment variables? │ Yes │ ◇ Environment variable name: │ TODOIST_API_TOKEN │ ◇ Environment variable value: │ ▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪ │ ◇ Add another environment variable? │ No │ └ Added todoist extension

Now you can run goose and ask it questions about your todo list, or make changes.

$ goose starting session | provider: ollama model: phi-4 logging to ****** working directory: ****** Goose is running! Enter your instructions, or try asking what goose can do. ( O)> how many todo list tasks have I completed in the last 7 days ─── todoist_get_tasks | todoist ────────────────────────── filter: last 7 days completed ... *Ideally* You have been very busy this week. You have completed 15 tasks! Listed below are the tasks. ...

Available Tools

To see currently available tools, run

# With GNU grep installed as ggrep (as with `brew install grep` on Mac) ggrep -Po '(?<=^mcp.tool\(\)\()([^)]+)' src/main.py

As of 2025-05-26,

  • Projects
    • todoist_get_projects
    • todoist_get_project
    • todoist_add_project
    • todoist_update_project
    • todoist_delete_project
  • Sections
    • todoist_get_sections
    • todoist_get_section
    • todoist_add_section
    • todoist_update_section
    • todoist_delete_section
  • Tasks
    • todoist_get_task
    • todoist_get_tasks
    • todoist_filter_tasks
    • todoist_add_task
    • todoist_update_task
    • todoist_complete_task
    • todoist_uncomplete_task
    • todoist_move_task
    • todoist_delete_task
  • Comments
    • todoist_get_comment
    • todoist_get_comments
    • todoist_add_comment
    • todoist_update_comment
    • todoist_delete_comment

License

This project is licensed under the MIT License. See the LICENSE file for details.

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

Сервер Python, который позволяет Клоду взаимодействовать с API управления задачами Todoist, позволяя пользователям создавать, управлять и организовывать задачи непосредственно через интерфейс Клода.

  1. Установка
    1. Предпосылки
    2. Получение токена API Todoist
    3. Конфигурация с Claude Desktop
  2. Доступные инструменты
    1. Лицензия

      Related MCP Servers

      • A
        security
        A
        license
        A
        quality
        Integrates Claude with Todoist for natural language task management, supporting project and section organization, task creation, updating, completion, and deletion using everyday language.
        Last updated -
        6
        19
        MIT License
      • 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 -
        497
        308
        MIT License
      • -
        security
        F
        license
        -
        quality
        A Model Context Protocol server that enables Claude to interact with your Todoist account, allowing you to manage tasks, projects, and labels through natural language.
        Last updated -
        1
      • -
        security
        A
        license
        -
        quality
        A Model Context Protocol server that enables advanced task and project management in Todoist via Claude Desktop and other MCP-compatible clients.
        Last updated -
        66
        1
        MIT License

      View all related MCP servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/mikemc/todoist-mcp-server'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server