Log inSubmit server
Todoist MCP Server logo

Todoist MCP Server

Connects AI clients to Todoist for reading and changing tasks and projects through MCP, OAuth, or a local npm process.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Todoist MCP Server

Pick your client, then add it in one click or paste the config.

Streamable HTTP (Remote)
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "todoist-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@doist/todoist-mcp"
      ],
      "env": {
        "TODOIST_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Hosted endpointLive · TodayLive Remote EndpointOur automated health check connected to this remote MCP endpoint successfully.Last checked 11/11/2026, 12:00:31 AM

Clients with native remote MCP support can connect directly to this URL.

Remote endpoint
https://ai.todoist.net/mcp

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

Todoist MCP Server connects AI clients to Todoist and lets them find, add, update, and complete tasks and projects. It can use Todoist's hosted streamable HTTP endpoint at https://ai.todoist.net/mcp with OAuth, or run locally through the @doist/todoist-mcp npm package. The same tools can also be imported into applications such as conversational interfaces built with Vercel's AI SDK. Reach for it when an agent needs to manage Todoist data rather than only answer questions about it.

Use cases

  • Find tasks scheduled for a particular date
  • Add Todoist tasks from a conversational request
  • Update or complete tasks through an AI client
  • Review task lists with MCP App widgets
  • Embed Todoist tools in a custom AI interface

Key features

  • Task and project lookup
  • Task creation, updates, and completion
  • Hosted streamable HTTP endpoint with OAuth
  • Local npm execution
  • OpenAI-compatible search and fetch tools
  • Reusable tools for custom AI applications

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned just now via OSV.dev · @doist/todoist-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars563Stargazers on the source repository.
Last commitTodayMost recent push to the default branch.

How Todoist MCP Server works

What Todoist MCP Server does

Todoist MCP Server gives AI agents access to Todoist accounts through the Model Context Protocol. Its task and project workflows cover finding tasks, adding new tasks, updating existing items, and marking tasks complete. The server is maintained by Doist and uses the official Todoist TypeScript API client.

The package is also usable as a library. Applications can import individual tools and attach them to their own AI interface instead of communicating with the MCP server. The repository demonstrates this pattern with findTasksByDate and addTasks used through Vercel's AI SDK.

How it works

The hosted deployment exposes a streamable HTTP MCP endpoint at https://ai.todoist.net/mcp. Clients that support HTTP MCP connections can connect there and authenticate with Todoist through OAuth. Todoist access can be revoked later from Todoist's Settings under Integrations.

For local use, launch the package with npx @doist/todoist-mcp. The repository also supports direct tool execution for development and testing. In that mode, the Todoist API client reads TODOIST_API_KEY, and the project recommends checking the connected account with the user-info tool before performing write operations.

The server includes search and fetch tools that follow OpenAI's MCP specification. Their results are JSON-encoded for OpenAI-compatible use while remaining usable within the broader MCP ecosystem.

Setup and configuration

For the hosted service, configure an MCP client with the streamable HTTP URL and complete the OAuth flow. Claude Desktop uses its custom connector flow; Cursor can use mcp-remote; Claude Code supports either the official Todoist plugin or a manual HTTP MCP entry; Gemini CLI provides an official Todoist extension; and Visual Studio Code can add the URL as an HTTP server.

To use the package locally, install or invoke it with npm. For repository development, npm run setup creates a .env file from .env.example; direct tool execution then uses the API key in that file. Test accounts or temporary projects are appropriate for write-operation checks because the tools can modify real Todoist data.

Tools and capabilities

  • Find Todoist tasks, including date-based lookup through findTasksByDate.
  • Add tasks with addTasks.
  • Update and complete Todoist tasks and projects.
  • Expose search and fetch for OpenAI MCP compatibility.
  • List available tools with npm run tool:list.
  • Execute a selected tool with JSON arguments through npm run tool -- <tool-name> '<json-args>'.
  • Render interactive MCP App widgets for tool output, including task-list views.

The repository's tools are not tied exclusively to MCP. Developers can import them into other conversational AI applications and provide a Todoist API client when executing them.

Limitations and notes

The project describes itself as being in an early stage, with a small tool set intended to support complete workflows. The hosted OAuth path does not require a local API key, while local direct execution uses TODOIST_API_KEY. Write operations change Todoist data, so account and project selection should be checked before testing them. The MCP Apps support depends on AI clients that can render inline interactive widgets; clients may otherwise receive ordinary tool results.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Todoist MCP Server

Todoist MCP Server is an MCP server that connects AI clients to Todoist accounts. Its main tools let agents find, add, update, and complete tasks and projects, with search and fetch tools for OpenAI MCP compatibility. It can run through Doist’s hosted OAuth endpoint or locally from the npm package.

Run `npx @doist/todoist-mcp` to start the local package. For hosted use, configure an MCP client with `https://ai.todoist.net/mcp` and authenticate with OAuth. The package can also be installed as `@doist/todoist-mcp` when importing its tools into another application.

Yes, Todoist MCP Server works with Claude Desktop through a custom connector. Add `https://ai.todoist.net/mcp` under Settings → Connectors → Add custom connector, then complete the OAuth authentication flow.

Configure it in Cursor with `mcp-remote` and the hosted endpoint. Add a `todoist` entry to `~/.cursor/mcp.json` or `.cursor/mcp.json`, set the command to `npx`, and pass `-y`, `mcp-remote`, and `https://ai.todoist.net/mcp` as arguments.

The hosted service does not require an API key because it uses OAuth. Local direct tool execution uses `TODOIST_API_KEY`, read from the project’s `.env` file, while applications importing the tools create a Todoist API client with that key.

Related MCP servers

All in Workplace & Productivity All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewTodoist MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/todoist-mcp-server?style=directory)](https://allmcps.com/mcp/todoist-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/todoist-mcp-server"><img src="https://allmcps.com/api/badge/todoist-mcp-server?style=directory" alt="Todoist MCP Server on AllMCPs" /></a>