MCP.so
Sign In

πŸš€ TaskMaster: Todoist MCP for Cursor AI

@mingolladaniele

About πŸš€ TaskMaster: Todoist MCP for Cursor AI

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.

Basic information

Category

Productivity

Runtime

python

Transports

stdio

Publisher

mingolladaniele

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is πŸš€ TaskMaster: Todoist MCP for Cursor AI?

A Model Context Protocol (MCP) server implementation that integrates Todoist with Cursor AI. It allows Cursor AI assistants to retrieve and filter tasks from a Todoist account directly from the coding environment.

How to use πŸš€ TaskMaster: Todoist MCP for Cursor AI?

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.

Key features of πŸš€ TaskMaster: Todoist MCP for Cursor AI

  • 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

Use cases of πŸš€ TaskMaster: Todoist MCP for Cursor AI

  • View today’s tasks without leaving the code editor
  • Identify overdue tasks to re-prioritize work
  • Query tasks due before or after a given date
  • List tasks with no due date for housekeeping
  • Filter recurring tasks to review schedule

FAQ from πŸš€ TaskMaster: Todoist MCP for Cursor AI

What are the prerequisites to use this server?

You need Python 3.10 or higher, Poetry for dependency management, and a Todoist account with an API token.

How do I obtain a Todoist API token?

Go to Todoist settings β†’ Integrations β†’ Developer to generate your API token.

How do I configure it for Cursor AI?

Create or edit the file at C:\Users\<username>\.cursor\mcp.json (Windows) or the equivalent on Linux/macOS, adding the server command, arguments, and environment variable TODOIST_API_TOKEN. After saving, Cursor Settings β†’ MCP should show a green dot when the server is running.

What filter strings does the get_tasks_tool support?

The tool accepts any valid Todoist filter query, such as "today", "overdue", "due before: May 5", "no date", "recurring", "5 days", and priority numbers 1–4.

Does TaskMaster currently support creating or completing tasks?

No. The current version only provides the get_tasks_tool for task retrieval. Task creation, completion, deletion, and other features are planned for future releases.

Comments

More Productivity MCP servers