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.

Development

To set up the project for development:

1. Clone the repository:

   Copy

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

2. Install dependencies:

   Copy

   npm install

3. Run the linter:

   Copy

   npm run lint

4. Build the project:

   Copy

   npm run build

Support

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

npm install

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

   Copy

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

   NPX

   Copy

   {
     "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"