🚀 TaskMaster: Todoist MCP for Cursor AI
@mingolladaniele
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.
概览
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.
