Todoist MCP Server

How to use

You interact with the Todoist MCP server through an MCP client. After configuring the server, you can ask Claude to perform common Todoist actions, such as listing projects, creating tasks, updating task details, or filtering tasks by due date or label. The tools expose straightforward actions like listing, creating, updating, completing, reopening, and deleting tasks, as well as listing and creating projects and labels. Use natural language requests and Todoist-like filter syntax to get precise results.

Examples of practical actions you can perform include asking Claude to show today’s tasks, create a high-priority task in a specific project, or retrieve details for a particular project. You can also request overdue items or filter tasks by label or project to focus your work.

How to install

Prerequisites you need before installing: a runtime for the chosen installation method and access to the Todoist API token.

Option 1: uvx (Recommended) install and run

{
  "mcpServers": {
    "todoist": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/IAMSamuelRodda/todoist-mcp", "todoist-mcp"],
      "env": {
        "TODOIST_API_TOKEN": "your-api-token"
      }
    }
  }
}

To enable this method, add the configuration above to your MCP client configuration file and replace your-api-token with your actual API token.

Option 2: Local Clone install

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 your MCP client configuration file:
```
{
  "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"
      }
    }
  }
}

To start using this method, replace your-api-token with your actual API token and ensure your virtual environment is activated before running Claude.

Get Your API Token

1. Open Todoist (web or app) 2. Go to Settings → Integrations → Developer 3. Copy your API token

Additional configuration and notes

Environment variable you must provide is the Todoist API token. The token gives Claude access to your Todoist data for the specified actions.

Updating the Todoist MCP server depends on your installation method. If you used uvx, refresh the cache for the server. If you used a local clone, pull the latest changes and reinstall dependencies if needed.

Security and best practices

Keep your API token secure and do not share it. Use environment variable configuration to avoid embedding the token in code or command history. Rotate tokens periodically and restrict access to your MCP client configuration.

Troubleshooting

If Claude cannot perform Todoist actions, verify that the API token is correct and that the MCP server is reachable from your client. Check that the required dependencies are installed for your chosen installation method and ensure the virtual environment is active for the local clone option.

todoist_list_projects

List all projects in Todoist.

todoist_get_project

Get detailed information about a specific project.

todoist_create_project

Create a new project, including sub-projects.

todoist_list_tasks

List tasks with optional filters and date constraints.

todoist_get_task

Get details for a single task.

todoist_create_task

Create a new task with title, due date, and assignments.

todoist_update_task

Update properties of an existing task.

todoist_complete_task

Mark a task as complete.

todoist_reopen_task

Reopen a previously completed task.

todoist_delete_task

Delete a task.

todoist_list_labels

List all labels available in Todoist.

todoist_create_label

Create a new label for task organization.