Todoist

You can manage Todoist tasks, projects, sections, comments, reminders, and more through a dedicated MCP server that connects to Todoist via API v1. This enables seamless task automation from any MCP-compatible client, letting you orchestrate your work with natural language dates, batch operations, and powerful querying.

How to use

Connect your MCP client to the Todoist MCP Server using the HTTP transport. Once connected, you can create, read, update, and delete tasks and projects, manage sections and labels, add comments with attachments, set reminders, and run bulk operations across multiple tasks. Use natural language date inputs to schedule tasks and leverage filters and completed-task queries to analyze your work history. Start by linking your MCP client to the provided endpoint and exploring the available actions through your client’s command palette or UI.

How to install

Prerequisites: you need a Todoist account and a Todoist API token. You also need an MCP client to connect to the server.

Installation steps for using the Todoist MCP Server over HTTP (no local server running on your machine):

{
  "mcpServers": {
    "todoist": {
      "transport": {
        "type": "http",
        "url": "https://todoist.uberfolks.ca/mcp"
      }
    }
  }
}

Configuration

Configure your MCP client to use the Todoist HTTP endpoint. If you are developing locally, you can run against a local instance at http://localhost:3000/mcp once you have a local dev server running.

{
  "mcpServers": {
    "todoist": {
      "transport": {
        "type": "http",
        "url": "http://localhost:3000/mcp"
      }
    }
  }
}

Security and environment

Your Todoist API token is required to authorize requests to the Todoist API. Store it securely as an environment variable in your hosting environment or deployment platform.

TODOIST_API_TOKEN=your_token_here

Notes and troubleshooting

If you encounter rate-limit messages, implement automatic retries or stagger requests from your MCP client. For local development, ensure the server URL in your client matches the running endpoint and that your Todoist token is valid.

Available tools

todoist_tasks

Complete task management with create, get, update, delete, list, complete, uncomplete, and list_completed actions. Supports natural language dates, deadlines, priorities, labels, recurring tasks, and querying completed tasks within time-bounded windows.

todoist_projects

Manage projects with create, get, update, delete, list, archive, and unarchive actions.

todoist_sections

Manage sections within projects for organizing tasks.

todoist_comments

Add and manage comments on tasks and projects with file attachment support.

todoist_filters

Create and manage custom filters for advanced task queries.

todoist_reminders

Set reminders for tasks including relative, absolute, and location-based types.

todoist_labels

Manage personal and shared labels with create, get, update, delete, and list actions.

todoist_bulk_tasks

Perform bulk operations on up to 50 tasks with actions like update, complete, uncomplete, and move.