Todoist MCP Server

The Todoist MCP Server is an implementation of the Model Context Protocol, designed to integrate Claude with Todoist for natural language task management. It allows Claude to interact with Todoist tasks using everyday language.

<a href="https://glama.ai/mcp/servers/fhaif4fv1w"> <img width="380" height="200" src="https://glama.ai/mcp/servers/fhaif4fv1w/badge" alt="Todoist Server MCP server" /> </a>

Features

• Natural Language Task Management: Create, update, complete, and delete tasks using natural language.
• Smart Task Search: Find tasks using partial name matches.
• Flexible Filtering: Filter tasks by due date, priority, and other attributes.
• Rich Task Details: Supports descriptions, due dates, and priority levels.
• Intuitive Error Handling: Provides clear feedback for better user experience.

Installation

Installing via Smithery

To install Todoist MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude

Manual Installation

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

Tools

• todoist_create_task: Creates new tasks with content, description, due date, and priority.
• todoist_get_tasks: Retrieves and filters tasks by due date, priority, or project.
• todoist_update_task: Updates existing tasks by partial name match, modifying attributes.
• todoist_complete_task: Marks tasks as complete using natural language search.
• todoist_delete_task: Removes tasks using natural language search and confirmation messages.

Getting a Todoist API Token

1. Log in to your Todoist account.
2. Navigate to Settings ⌘†’ Integrations.
3. Find your API token under "Developer".

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@abhiz123/todoist-mcp-server"],
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Example Usage

Creating Tasks

"Create task 'Team Meeting'"
"Add task 'Review PR' due tomorrow at 2pm"
"Create high priority task 'Fix bug' with description 'Critical performance issue'"

Getting Tasks

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

Updating Tasks

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

Completing Tasks

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

Deleting Tasks

"Delete the PR review task"
"Remove meeting prep task"

Development

Building from source

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

# Navigate to directory
cd todoist-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Contributing

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 file an issue on the GitHub repository.