Todoist-MCP-Extension

Todoist MCP Extension

A Model Context Protocol (MCP) extension that allows Claude to interact with your Todoist account for comprehensive task management.

Features

This extension provides Claude with powerful tools to manage your Todoist tasks:

📝 Task Management

• Create tasks with descriptions, due dates, priorities, and labels
• Get tasks with flexible filtering (by project, label, date, etc.)
• Update tasks to modify content, due dates, or other properties
• Complete tasks to mark them as done
• Delete tasks when no longer needed

📂 Project Organization

• Create projects to organize your tasks
• Get all projects to see your workspace structure
• Update projects to change names, colors, or settings
• Delete projects when they're no longer needed

🏷️ Label Management

• Create labels for better task categorization
• Get all labels to see available tags
• Assign labels to tasks during creation or updates

💬 Comments & Collaboration

• Add comments to tasks or projects
• Get comments to review discussions and notes

Installation

Prerequisites

1. Todoist Account: You'll need a Todoist account
2. API Token: Get your personal API token from Todoist Integrations Settings
3. Claude Desktop: This extension requires Claude Desktop with MCP support

Setup Steps

1. Get Your Todoist API Token:

   • Visit https://todoist.com/prefs/integrations
   • Scroll down to "API token"
   • Copy your personal token (keep this secure!)

2. Install the Extension:

   • Download the todoist-mcp.dxt file
   • Open Claude Desktop
   • Go to Settings → Extensions
   • Drag and drop the .dxt file or click "Install Extension"
   • Enter your Todoist API token when prompted

3. Start Using:

   • The extension will be available immediately
   • Ask Claude to help with your tasks!

Usage Examples

Here are some example requests you can make to Claude:

Basic Task Management

"Create a task called 'Review quarterly budget' due tomorrow with high priority"

"Show me all my tasks for today"

"Mark task 'Buy groceries' as completed"

"Update the task 'Team meeting' to be due next Monday at 2 PM"

Project Organization

"Create a new project called 'Home Renovation'"

"Show me all my projects"

"Move the task 'Paint living room' to my Home Renovation project"

Advanced Filtering

"Show me all overdue tasks"

"Get all tasks labeled 'urgent' from my Work project"

"Show me tasks due this week in my Personal project"

Labels and Organization

"Create a label called 'waiting-for-response'"

"Add the 'urgent' label to my task about the client presentation"

"Show me all tasks with the 'shopping' label"

Comments and Notes

"Add a comment to the 'Prepare presentation' task: 'Need to include Q3 sales data'"

"Show me all comments on my 'Website redesign' project"

Prompts

The extension includes helpful prompts for common workflows:

• Daily Tasks: "Show today's tasks and help prioritize them"
• Weekly Planning: "Review this week's tasks and help plan ahead"
• Project Overview: "Get an overview of a specific project"

API Reference

Available Tools

Task Tools

• create_task - Create a new task
• get_tasks - Retrieve tasks with filtering
• update_task - Modify existing tasks
• complete_task - Mark tasks as completed
• delete_task - Remove tasks

Project Tools

• create_project - Create new projects
• get_projects - List all projects
• update_project - Modify project settings
• delete_project - Remove projects

Label Tools

• create_label - Create new labels
• get_labels - List all labels

Comment Tools

• create_comment - Add comments to tasks/projects
• get_comments - Retrieve comments

Due Date Formats

The extension supports flexible due date formats:

• Natural language: "tomorrow", "next Monday", "in 3 days"
• Specific dates: "2024-12-25" (YYYY-MM-DD format)
• Date and time: "2024-12-25T14:30:00Z" (ISO 8601 format)

Priority Levels

• 1 - Normal (default)
• 2 - Medium
• 3 - High
• 4 - Urgent

Security & Privacy

• Your API token is stored securely in your system's keychain
• All communication is direct between your computer and Todoist's servers
• No data is sent to third parties
• The extension runs locally on your machine

Troubleshooting

Common Issues

"Invalid API token" error:

• Verify your token is correct at Todoist Integration Settings
• Make sure you copied the full token without extra spaces

"Extension not loading":

• Ensure you have the latest version of Claude Desktop
• Check that the extension file isn't corrupted
• Restart Claude Desktop

"Permission denied" errors:

• Your Todoist account may have restrictions
• Some features require Todoist Pro subscription

Getting Help

If you encounter issues:

1. Check the Todoist API status at status.todoist.com
2. Verify your internet connection
3. Try reinstalling the extension
4. Contact support with specific error messages

Version History

v1.0.0

• Initial release
• Full task, project, label, and comment management
• Support for all major Todoist features
• Natural language due date parsing
• Secure API token storage

License

MIT License - Feel free to modify and distribute

Contributing

Found a bug or want to add a feature? Contributions welcome!