Todoist

Todoist

Search, add, and update Todoist tasks, projects, sections, comments, and more.

197
Stars
22
Forks
20
Releases

Overview

Todoist AI MCP server is a streamable HTTP service that lets AI agents search, fetch, and manage Todoist data through the MCP protocol. The server includes a focused set of tools designed to support complete Todoist workflows rather than single actions; notably, it provides search and fetch tools that follow the OpenAI MCP specification, delivering JSON-encoded results optimized for OpenAI clients while remaining compatible with the broader MCP ecosystem. The MCP server can be run directly with npx and is reachable at the primary URL https://ai.todoist.net/mcp, facilitating integration with a variety of AI clients including Claude Desktop, Cursor, Claude Code, and Visual Studio Code. In addition to its MCP capabilities, the server is designed to be reused as a library of tools that can be wired into other conversational interfaces outside the MCP setting. It relies on the official @modelcontextprotocol/sdk and the Todoist TypeScript API client to perform Todoist operations and includes references to docs for mcp-server.md and dev-setup.md to guide setup, testing, and local development. OAuth-based authentication flows enable Todoist access via browser-based sign-in through the various clients.

Details

Owner
doist
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

OpenAI MCP Compatible Tools

The server includes search and fetch tools that follow the OpenAI MCP specification, returning JSON-encoded results optimized for OpenAI MCP integration while remaining compatible with the broader MCP ecosystem.

Streamable HTTP MCP Endpoint

Accessible at https://ai.todoist.net/mcp, enabling easy integration with Claude Desktop, Cursor, Claude Code, Visual Studio Code, and other MCP clients.

Reusable Tools Across Interfaces

Tools can be reused outside the MCP server and hooked into other conversational AI interfaces, not limited to the MCP workflow.

OAuth Todoist Authentication Flows

Supports browser-based OAuth authentication with Todoist via different clients as described in the setup, enabling access to Todoist data.

Official MCP Server SDK and Todoist API Client

Built using the official Model Context Protocol SDK and the Todoist TypeScript API client for reliable integration.

Documentation and Setup Guides

Provides documentation for MCP server setup (docs/mcp-server.md) and local development (docs/dev-setup.md) and quick start instructions.

Audience

AI developersEnable AI agents to access and modify Todoist data via MCP.
Product teamsEnable AI-powered Todoist automation in product workflows and internal assistants.
MCP server developersIntegrate and extend Todoist tools inside custom MCP servers and clients.

Tags

TodoistAIMCP serverOpenAI MCPstreamable HTTPOAuthTodoist APItools