Todoist

This Todoist MCP Server provides a complete integration with the Todoist API using Nango authentication. It lets you manage tasks, projects, and labels through MCP clients with a streamlined setup that works with npx, Docker, or local development.

How to use

You can operate the Todoist MCP Server from an MCP client by running the MCP’s stdio or HTTP entry points. Use the MCP server to list, create, and update tasks, projects, and labels in Todoist through a consistent API surface. Start the server in your preferred environment and then connect your MCP client to it using the provided connection details and environment variables.

How to install

Prerequisites you need before installing: a current Node.js and npm installed on your machine, and optionally Docker if you prefer containerized usage.

Using npx (Recommended) you can run the MCP server without committing built files.

# Quick start with npx
npx -y git+https://github.com/ampcome-mcps/todoist-mcp.git

Using Docker you can build and run the MCP server in a container. Replace the placeholder environment values with your actual IDs and secret.

docker build -t todoist-mcp .
docker run -it --rm \
  -e NANGO_CONNECTION_ID="your_connection_id" \
  -e NANGO_INTEGRATION_ID="your_integration_id" \
  -e NANGO_BASE_URL="https://api.nango.dev" \
  -e NANGO_SECRET_KEY="your_secret_key" \
  todoist-mcp

Local development lets you clone the project, install dependencies, build, and run the server locally.

git clone https://github.com/ampcome-mcps/todoist-mcp.git
cd todoist-mcp
npm install
npm run build
npm start

Configuration

Set these environment variables before you start the server to enable Nango authentication and Todoist API access.

NANGO_CONNECTION_ID=your_connection_id
NANGO_INTEGRATION_ID=your_integration_id
NANGO_BASE_URL=https://api.nango.dev
NANGO_SECRET_KEY=your_secret_key

Claude Desktop Configuration

If you use Claude Desktop, you can configure the MCP server like this to run via npx with the required environment variables.

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "git+https://github.com/ampcome-mcps/todoist-mcp.git"],
      "env": {
        "NANGO_CONNECTION_ID": "your_connection_id",
        "NANGO_INTEGRATION_ID": "your_integration_id",
        "NANGO_BASE_URL": "https://api.nango.dev",
        "NANGO_SECRET_KEY": "your_secret_key"
      }
    }
  }
}

Available features and endpoints

This MCP server exposes a set of endpoints to manage Todoist resources. The core capabilities include listing and creating tasks, projects, and labels, as well as marking tasks as complete. Use these capabilities from your MCP client to automate Todoist workflows.

Available tools

listTasks

List tasks with filters to tailor results to your needs.

createTask

Create a new task with a title, due date, and optional notes or labels.

completeTask

Mark a task as completed to update your Todoist workspace.

listProjects

Retrieve a list of all projects in Todoist for overview and selection.

createProject

Create a new project to organize tasks under a specific context.

listLabels

List all labels to classify and filter tasks.

createLabel

Create a new label for tagging tasks and projects.