TaskMaster Todoist

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.

python

43

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mingolladaniele-taskmaster-todoist-mcp": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "env": {
        "TODOIST_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

You run a TaskMaster MCP server that lets Cursor AI access and manage your Todoist tasks directly from your coding environment. It supports flexible filtering, rich task formatting, and seamless integration so you can query tasks, deadlines, and priorities without leaving your editor.

How to use

You connect using an MCP client by configuring an MCP entry that points to your local TaskMaster Todoist MCP server. Start the server and ensure the connection shows as running in your Cursor AI settings. Use the server’s get_tasks_tool to fetch tasks with advanced filters such as due dates, priorities, or combinations of criteria. The tool returns tasks with their priority, due date, and other useful details so you can act on them from within your coding workflow.

How to install

Prerequisites you need before installation are Python 3.10 or higher, Poetry for dependency management, and a Todoist account with an API token.

Step 1: Install Python dependencies

pip install -r requirements.txt

Step 2: Set your Todoist API token as an environment variable

# Linux/macOS
export TODOIST_API_TOKEN="your-api-token-here"

# Windows
set TODOIST_API_TOKEN="your-api-token-here"

Step 3: Run the server

python server.py

Step 4: Configure Cursor AI to connect to the MCP server

{
  "mcpServers": {
    "todoist_mcp": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Additional notes

The server exposes a single MCP tool named get_tasks_tool that accepts a filter_string and an optional priority to refine task results. Use this to pull exactly the tasks you need, such as overdue items, due today, or tasks with no due date.

Security and maintenance

Keep your Todoist API token secure. Do not commit it to code repositories. Rotate tokens periodically and use environment variables to supply credentials at runtime. Regularly update dependencies to keep the MCP server secure and compatible with Cursor AI.

Available tools

get_tasks_tool

Retrieves tasks from Todoist with advanced filters. Supports filter_string for complex Todoist queries and an optional priority to narrow results.