Abhiz123 Todoist MCP Server

🚀 Todoist MCP Server

An implementation of the MCP (Model Context Protocol) server that integrates Claude with Todoist, enabling task management through everyday language. This server allows Claude to interact with your Todoist tasks using natural language.

🚀 Quick Start

The Todoist MCP Server is an innovative solution that combines Claude and Todoist, enabling seamless task management using natural language. With this server, you can effortlessly create, update, complete, and delete tasks, all through simple everyday language interactions.

✨ Features

• Natural Language Task Management: Create, update, complete, and delete tasks using everyday language.
• Intelligent Task Search: Find tasks by partial name matching.
• Flexible Filtering: Filter tasks by due date, priority, and other attributes.
• Comprehensive Task Details: Support descriptions, due dates, and priority levels.
• Intuitive Error Handling: Clear feedback to enhance the user experience.

📦 Installation

npm install -g @abhiz123/todoist-mcp-server

📚 Documentation

todoist_create_task

Create a new task with various attributes:

• Required: Content (task title)
• Optional: Description, due date, priority level (1-4)
• Example: "Create task 'Team Meeting' with description 'Weekly sync' and set it for tomorrow."

todoist_get_tasks

Retrieve and filter tasks:

• Filter by due date, priority, or project.
• Use natural language dates for filtering.
• Optional result limit.
• Example: "Show high-priority tasks for this week."

todoist_update_task

Update an existing task using natural language search:

• Find tasks by partial name matching.
• Update any task attribute (content, description, due date, priority).
• Example: "Set the 'Meeting Task' to be due next Monday."

todoist_complete_task

Mark a task as completed using natural language search:

• Find and delete tasks by name.
• Confirm completion status.
• Example: "Mark the 'Documentation Task' as completed."

todoist_delete_task

Delete a task using natural language search:

• Find and delete tasks by name.
• Display a confirmation message.
• Example: "Delete the 'Code Review Task'."

🛠️ Setup

Obtain a Todoist API Token

1. Log in to your Todoist account.
2. Go to Settings → Integrations.
3. Find the API token in the "Developers" section.

Use with Claude Desktop

Add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@abhiz123/todoist-mcp-server"],
      "env": {
        "TODOIST_API_TOKEN": "Enter your API token here"
      }
    }
  }
}

💻 Usage Examples

Create Tasks

"Create task 'Team Meeting'"
"Add task 'Review PR' and set it for tomorrow"
"Create a high-priority task 'Fix Bug' with description 'Critical performance issue'"

Get Tasks

"Show all my tasks"
"List tasks due today"
"Get high-priority tasks"
"Show tasks due this week"

Update Tasks

"Set the documentation task to be due next week"
"Change the priority of the bug fix task to urgent"
"Add a description to the team meeting task"

Complete Tasks

"Mark the PR review task as completed"
"Complete the documentation task"

Delete Tasks

"Delete the code review task"
"Delete the meeting preparation task"

🔧 Technical Details

Build from Source

# Clone the repository
git clone https://github.com/abhiz123/todoist-mcp-server.git

# Navigate to the directory
cd todoist-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

🤝 Contribution

Contributions are welcome! Feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

❓ Issues and Support

If you encounter any issues or need support, please submit an issue on the GitHub repository.