Todoist MCP Server

by MCP-Mirror

351 downloads
Not rated
GitHub

About

An MCP (Model Context Protocol) server that integrates Claude with Todoist, enabling natural language task management. It allows Claude to create, read, update, complete, and delete Todoist tasks using everyday language rather than direct API calls.

Details

Author
MCP-Mirror
Downloads
351
Categories
Productivity, Project Management

- Natural language task management (create, update, complete, delete)
- Smart task search using partial name matches
- Flexible filtering by due date, priority, or project
- Support for rich task details (descriptions, due dates, priority)
- Clear error and confirmation feedback for user actions

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Todoist MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install globally via npm: npm install -g @abhiz123/todoist-mcp-server. Then add a todoist entry to your claude_desktop_config.json with the command npx -y @abhiz123/todoist-mcp-server and provide your Todoist API token in the TODOIST_API_TOKEN environment variable. After configuration, you can interact with tasks using natural language commands through Claude.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

Todoist MCP Server

An MCP (Model Context Protocol) server implementation that integrates Claude with Todoist, enabling natural language task management. This server allows Claude to interact with your Todoist tasks using everyday language.

Features

Natural Language Task Management: Create, update, complete, and delete tasks using everyday language
Smart Task Search: Find tasks using partial name matches
Flexible Filtering: Filter tasks by due date, priority, and other attributes
Rich Task Details: Support for descriptions, due dates, and priority levels
Intuitive Error Handling: Clear feedback for better user experience

Installation

npm install -g @abhiz123/todoist-mcp-server

Tools

todoist_create_task

Create new tasks with various attributes:
Required: content (task title) Optional: description, due date, priority level (1-4) Example: "Create task 'Team Meeting' with description 'Weekly sync' due tomorrow"

todoist_get_tasks

Retrieve and filter tasks: Filter by due date, priority, or project Natural language date filtering Optional result limit Example: "Show high priority tasks due this week"

todoist_update_task

Update existing tasks using natural language search: Find tasks by partial name match Update any task attribute (content, description, due date, priority) Example: "Update meeting task to be due next Monday"

todoist_complete_task

Mark tasks as complete using natural language search:
Find tasks by partial name match Confirm completion status Example: "Mark the documentation task as complete"

todoist_delete_task

Remove tasks using natural language search: Find and delete tasks by name Confirmation messages
  • Example: "Delete the PR review task"

Setup

Getting a Todoist API Token

1. Log in to your Todoist account 2. Navigate to Settings → Integrations 3. Find your API token under "Developer"

Usage with Claude Desktop

Add to your claude_desktop_config.json:

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

Example Usage

Creating Tasks

"Create task 'Team Meeting'"
"Add task 'Review PR' due tomorrow at 2pm"
"Create high priority task 'Fix bug' with description 'Critical performance issue'"

Getting Tasks

"Show all my tasks"
"List tasks due today"
"Get high priority tasks"
"Show tasks due this week"

Updating Tasks

"Update documentation task to be due next week"
"Change priority of bug fix task to urgent"
"Add description to team meeting task"

Completing Tasks

"Mark the PR review task as complete"
"Complete the documentation task"

Deleting Tasks

"Delete the PR review task"
"Remove meeting prep task"

Development

Building from source

```bash
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.