todoist

This Todoist MCP Server exposes a set of Python-based MCP tools that integrate with Todoist via the Todoist API. The server implements actions for managing projects, sections, tasks, and comments, including retrieval, creation, updating, completion status changes, and deletions. You can query and manipulate Todoist data through the listed MCP tools (for example, todoist_get_tasks, todoist_add_task, todoist_update_task, todoist_complete_task, etc.). To use the server, ensure you have a valid Todoist API token and run the server through the uvx-based workflow described in the installation/configuration steps. Once running under the mcpServers configuration, Claude Desktop or Goose can dispatch commands to the server and return structured results for your tasks, projects, and comments.

Prerequisites:

• Python 3.10 or newer
• UV package manager (install guidance at https://docs.astral.sh/uv/getting-started/installation/)
• Todoist API token (required to authenticate with the Todoist API)

Installation steps:

1. Install Python and verify python3 --version outputs 3.10+.
2. Install the UV package manager following the official guide:
   • Visit https://docs.astral.sh/uv/getting-started/installation/
   • Follow the instructions for your OS to install the uv tool.
3. Obtain a Todoist API token from Todoist:
   • Log in to Todoist
   • Settings -> Integrations -> Developer token
   • Copy the token value
4. Install or clone the MCP server repository:
   • You can run the server directly via uvx by pointing to the GitHub source, or clone locally for development:
     • Local copy (recommended for development): git clone https://github.com/mikemc/todoist-mcp-server.git cd todoist-mcp-server
5. Run the server using uvx (from the local copy or a Git URL):
   • From a local copy: uvx --from /absolute/path/to/todoist-mcp-server todoist-mcp
   • Or from the Git URL (as shown in the configuration example): uvx --from git+https://github.com/mikemc/todoist-mcp-server todoist-mcp
6. Provide your Todoist API token when prompted or set it via environment variable TODOIST_API_TOKEN as shown in the configuration example.

Note: If you are integrating with Claude Desktop or Goose, configure the mcpServers block as shown in the repository's sample configuration to automatically pass the token and run the server.

Tips and common issues:

• Ensure the Todoist API token has the necessary permissions for the actions you intend to perform.
• When running via Goose, use the provided environment variable TODOIST_API_TOKEN to avoid exposing tokens in scripts.
• If you encounter authentication errors, double-check that the token is correctly set in the environment and that there are no stray spaces.
• The available tools include operations for Projects, Sections, Tasks, and Comments, with functions like todoist_get_tasks, todoist_add_task, todoist_update_task, todoist_complete_task, todoist_move_task, and analogous methods for projects, sections, and comments.
• When running locally, ensure your uvx command references the correct path to the repository and that network access to the Todoist API is not blocked by a firewall.
• Keep your uv package manager up to date to ensure compatibility with the server code and dependencies.