Todoist MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with Todoist, enabling AI assistants to manage tasks, projects, labels, sections, and comments through the Todoist API.

Configuration

This server requires a Todoist API token to function.

1. Get your API token:

   • Go to Todoist Settings.

   • Scroll down to the "API token" section.

   • Copy your personal API token.

2. Configure your MCP client: Add the server to your MCP client configuration, making sure to include your API token. For Claude Desktop, you would add one of the following to your claude_desktop_config.json:

   Docker

   {
     "mcpServers": {
       "todoist": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "-e",
           "TODOIST_API_TOKEN=your_api_token_here",
           "ghcr.io/ganievs/todoist-mcp-server:latest"
         ]
       }
     }
   }

   NPX

   {
     "mcpServers": {
       "todoist": {
         "command": "npx",
         "args": [
           "-y",
           "@ganiev/todoist-mcp-server"
         ],
         "env": {
           "TODOIST_API_TOKEN": "your_api_token_here"
         }
       }
     }
   }

Usage

Once configured, you can use natural language to interact with Todoist through your MCP client:

• "Create a task to buy groceries with high priority"

• "List all my projects"

• "Add a comment to the task about the meeting"

• "Create a new project for my vacation planning"

• "Show me all tasks with the 'urgent' label"

Development

To set up the project for development:

1. Clone the repository:

   git clone https://github.com/ganievs/todoist-mcp-server.git
   cd todoist-mcp-server

2. Install dependencies:

   npm install

3. Run the linter:

   npm run lint

4. Build the project:

   npm run build

Support

For issues and feature requests, please use the GitHub Issues page.