📝 Todoist-API-MCP

MCP server for Todoist API integration. Provides full access to Todoist functionality through a simple and convenient MCP protocol.

Key Features

• 🔄 Transport flexibility: support for various transport types - stdio, SSE, and HTTP Stream for different use cases

• 👥 Multi-user mode: in SSE/HTTP Stream modes, each client uses their own Todoist API token

• 🔒 Security: ability to restrict server access using an MCP Access token

• 🚀 Complete API: support for all main Todoist entities (tasks, projects, sections, labels, comments)

Related MCP server: mcp-todoist

Quick Start

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["todoist-api-mcp", "--mode", "stdio"],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_api_token"
      }
    }
  }
}

Advanced usage

# stdio mode (for single user)
npx todoist-api-mcp --mode stdio --todoist-token YOUR_TODOIST_API_TOKEN

# SSE mode (for multi-user access)
# Clients send their Todoist tokens via Authorization: Bearer TOKEN header
npx todoist-api-mcp --mode sse

# HTTP Stream mode (for multi-user access)
# Clients send their Todoist tokens via Authorization: Bearer TOKEN header
npx todoist-api-mcp --mode httpStream

# With MCP Access token restriction
npx todoist-api-mcp --mode sse --mcp-access-token YOUR_MCP_ACCESS_TOKEN

# Setting the port for HTTP modes
npx todoist-api-mcp --mode sse --port 8080

Transport Modes

• stdio: local mode for working through standard input/output streams. The Todoist API token is passed through the --todoist-token parameter or the TODOIST_API_TOKEN environment variable.

• sse (Server-Sent Events): HTTP mode with event support for multiple clients. Each client uses their own Todoist API token via the Authorization: Bearer TOKEN header. Server access can be restricted through an MCP Access token (--mcp-access-token), which is verified in the X-Mcp-Token header.

• httpStream: streaming HTTP mode for long-lived connections. Each client uses their own Todoist API token via the Authorization: Bearer TOKEN header. Server access can be restricted through an MCP Access token (--mcp-access-token), which is verified in the X-Mcp-Token header.

Available Tools

✅ Tasks

• Reading: retrieving task lists and detailed information

• Creating: adding new tasks with support for all Todoist parameters

• Updating: changing any parameters of existing tasks

• Closing/Opening: managing task completion status

• Deleting: completely removing tasks from Todoist

📁 Projects

• Reading: retrieving project lists and their contents

• Creating: adding new projects with parameter configuration

• Updating: changing parameters of existing projects

• Deleting: completely removing projects from Todoist

📋 Sections

• Reading: retrieving section lists and their contents

• Creating: adding new sections to projects

• Updating: changing parameters of existing sections

• Deleting: removing sections from projects

🏷️ Labels

• Reading: retrieving label lists

• Creating: adding new labels

• Updating: changing parameters of existing labels

• Deleting: removing labels from Todoist

💬 Comments

• Reading: retrieving comments for tasks and projects

• Creating: adding new comments

• Updating: changing comment content

• Deleting: removing comments

License

MIT