Skip to content
Todoist

TodoistMCP Server

by Doist
Released
v13.0.0
MIT
Repository Docs npm
Productivity

Summary

Doist's official Todoist MCP server — a hosted OAuth endpoint that lets an agent find, create and update tasks and projects, with inline MCP Apps widgets for task lists.

Features

  • Hosted streamable-HTTP endpoint at https://ai.todoist.net/mcp with browser OAuth
  • Workflow-shaped tools rather than one tool per REST endpoint
  • MCP Apps widgets that render task lists as interactive UI inline in the client
  • search and fetch tools following the OpenAI MCP conventions
  • Tools importable as a plain library into Vercel AI SDK agents

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it.
  3. Restart the agent — the "Todoist" tools will be available.
{
  "mcpServers": {
    "todoist-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ai.todoist.net/mcp"
      ]
    }
  }
}

Description

The official MCP server for Todoist, built and hosted by Doist. It runs at https://ai.todoist.net/mcp as a streamable HTTP endpoint, so there is no key to paste anywhere: the first time an agent touches a Todoist tool, an OAuth flow opens in the browser and the grant is scoped to that user's account.

What makes it unusual

Two things separate it from the community Todoist servers.

The tools are a library first. Doist wrote them as reusable functions in @doist/todoist-mcp, not as MCP handlers with logic buried inside a server. You can import { findTasksByDate, addTasks } straight into a Vercel AI SDK agent and hand each one a TodoistApi client, which means the same behaviour an MCP client gets is available to a custom conversational interface without reimplementation.

It ships MCP Apps. Tool results can render as interactive UI widgets inline in the chat client — a real task list you can look at, rather than a paragraph of serialised JSON. That is one of the newer parts of the protocol and few production servers use it yet.

Design

Rather than exposing the Todoist REST API one endpoint per tool, the server deliberately keeps a small set of tools that cover complete workflows, and includes search and fetch following the OpenAI MCP conventions. Doist describe the project as early-stage with more tools coming.

Connecting it

Claude Code has an official plugin (/plugin marketplace add doist/todoist-mcp then /plugin install todoist@doist) that wires the server up in one step. Claude Desktop takes the URL directly as a custom connector. Cursor, VS Code and anything else reach it over mcp-remote. The package can also be run locally with npx @doist/todoist-mcp.

Related MCP Servers

MCP: Fireflies.ai

by Fireflies.ai

New

Fireflies.ai's official remote MCP server — 19 tools for searching meeting transcripts and summaries, pulling action items and analytics, and cutting soundbites from recorded calls.

Productivity

MCP: ClickUp

by ClickUp

New

ClickUp's official remote MCP server — around 40 tools across tasks, search, Docs, Chat and time tracking, over OAuth 2.1 with PKCE.

Productivity
1 views

MCP: Zoom Workspace MCP Server

by Zoom

New

Zoom's official hosted MCP server — semantic meeting search, AI Companion summaries, transcripts, recordings, and cross-Zoom search over Team Chat, Canvas and My Notes.

Productivity
3 views
Browse all MCP servers →