🚀 TaskMaster: Todoist MCP for Cursor AI

by mingolladaniele

42 stars
553 downloads
Not rated
GitHub

About

A lightweight Model Context Protocol (MCP) server that enables natural language interaction with your Todoist tasks directly from your IDE. Built with simplicity and maintainability in mind.

Details

Author
mingolladaniele
GitHub stars
42
Downloads
553
Categories
Productivity, Project Management, API

- Flexible task filtering using Todoist’s filter syntax
- Filter by due date (today, overdue, specific dates)
- Filter by priority level (1–4, where 1 is highest)
- Rich task display with priority, due date, and icons
- Designed for seamless use within Cursor AI

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 🚀 TaskMaster: Todoist MCP for Cursor AI
    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 via Smithery or clone the repository, set the TODOIST_API_TOKEN environment variable, and run python server.py. Then configure Cursor AI’s MCP settings by editing mcp.json with the correct path to the server script and your token. The get_tasks_tool tool is used to retrieve tasks with flexible filtering.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "\ud83d\ude80 taskmaster: todoist mcp for cursor ai": {
            "taskMaster-todoist-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@mingolladaniele/taskMaster-todoist-mcp",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

McpServers

{
    "taskMaster-todoist-mcp": {
        "command": "npx",
        "args": [
            "-y",
            "@smithery/cli",
            "install",
            "@mingolladaniele/taskMaster-todoist-mcp",
            "--client",
            "claude"
        ]
    }
}

🚀 TaskMaster: Todoist MCP for Cursor AI

smithery badge

A Model Context Protocol (MCP) server implementation for Todoist integration, specifically developed for Cursor AI. This server allows Cursor AI assistants to interact with your Todoist tasks directly from your coding environment.

Demo Video

TaskMaster Demo

Features

- Flexible Task Filtering: Filter tasks using Todoist's powerful filter syntax
- Filter by due date: today, tomorrow, overdue
- Filter by priority levels (1-4, where 1 is highest)
- Filter using complex query combinations
- Rich Task Formatting: Each task displays priority, due date, and other relevant information with clear icons
- Cursor AI Integration: Seamlessly use Todoist within your Cursor AI coding environment

Installation

Installing via Smithery

To install TaskMaster for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @mingolladaniele/taskMaster-todoist-mcp --client claude

Prerequisites

- Python 3.10 or higher
- Poetry (for dependency management)
- Todoist account and API token

Setup

1. Clone this repository:

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

2. Install dependencies:

pip install -r requirements.txt

3. Set your Todoist API token as an environment variable:
```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.