TaskMaster: Todoist MCP for Cursor AI
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
Features
- Flexible Task Filtering: Filter tasks using Todoist's powerful filter syntax
- 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
Prerequisites
- Python 3.10 or higher
- Poetry (for dependency management)
- Todoist account and API token
Setup
- Clone this repository:
- Install dependencies:
- Set your Todoist API token as an environment variable:
You can find your Todoist API token in Todoist settings Integrations Developer.
Usage
Running the server
MCP Tool
The server provides the following MCP tool:
`get_tasks_tool`
Retrieves tasks with powerful filtering options.
Parameters:
filter_string: Advanced Todoist filter query string for complex filtering
priority: Optional priority level (1-4, where 1 is highest priority)
Example filter strings:
"today"- Tasks due today
"overdue"- Overdue tasks
"Jan 3"- Tasks due on January 3rd
"due before: May 5"- Tasks due before May 5th
"due after: May 5"- Tasks due after May 5th
"due before: +4 hours"- Tasks due within the next four hours and all overdue tasks
"no date"- Tasks with no due date
"5 days"or"next 5 days"- Tasks due in the next 5 days
"recurring"- Tasks with a recurring date
Setting up with Cursor AI
To use with Cursor AI, create or edit the MCP configuration file:
Windows:
C:\Users\<username>\.cursor\mcp.jsonReplace
<username> and paths with your actual username and the correct paths to your installation.Once you do that, go to Cursor Settings MCP and check that the server is correctly running (green dot).
Project Structure
The codebase is organized into modules:
api/: API wrapper for Todoist
config/: Configuration and settings
utils/: Utility functions and helpers including task formatting
Roadmap
Here are the features planned for future releases:
- Task Creation: Add new tasks to your Todoist directly from Cursor AI
- Task Completion: Mark tasks as complete without switching context
- Task Deletion: Remove tasks that are no longer needed
- Smart Task Balancing: AI-powered task rebalancing based on:
- Project Management: Create and manage Todoist projects
- Labels and Filters: Add custom labels and create saved filters
License
MIT License
TaskMaster: Todoist MCP for Cursor AI
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
Features
- Flexible Task Filtering: Filter tasks using Todoist's powerful filter syntax
- 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
Prerequisites
- Python 3.10 or higher
- Poetry (for dependency management)
- Todoist account and API token
Setup
- Clone this repository:
- Install dependencies:
- Set your Todoist API token as an environment variable:
You can find your Todoist API token in Todoist settings Integrations Developer.
Usage
Running the server
MCP Tool
The server provides the following MCP tool:
`get_tasks_tool`
Retrieves tasks with powerful filtering options.
Parameters:
filter_string: Advanced Todoist filter query string for complex filtering
priority: Optional priority level (1-4, where 1 is highest priority)
Example filter strings:
"today"- Tasks due today
"overdue"- Overdue tasks
"Jan 3"- Tasks due on January 3rd
"due before: May 5"- Tasks due before May 5th
"due after: May 5"- Tasks due after May 5th
"due before: +4 hours"- Tasks due within the next four hours and all overdue tasks
"no date"- Tasks with no due date
"5 days"or"next 5 days"- Tasks due in the next 5 days
"recurring"- Tasks with a recurring date
Setting up with Cursor AI
To use with Cursor AI, create or edit the MCP configuration file:
Windows:
C:\Users\<username>\.cursor\mcp.jsonReplace
<username> and paths with your actual username and the correct paths to your installation.Once you do that, go to Cursor Settings MCP and check that the server is correctly running (green dot).
Project Structure
The codebase is organized into modules:
api/: API wrapper for Todoist
config/: Configuration and settings
utils/: Utility functions and helpers including task formatting
Roadmap
Here are the features planned for future releases:
- Task Creation: Add new tasks to your Todoist directly from Cursor AI
- Task Completion: Mark tasks as complete without switching context
- Task Deletion: Remove tasks that are no longer needed
- Smart Task Balancing: AI-powered task rebalancing based on:
- Project Management: Create and manage Todoist projects
- Labels and Filters: Add custom labels and create saved filters
License
MIT License