Todoist

What is todoist-mcp-server?

todoist-mcp-server is an MCP (Model Context Protocol) server that connects Claude, an AI assistant, with Todoist, a popular task management application. This integration allows users to manage their Todoist tasks using natural language commands through Claude, eliminating the need for manual input within the Todoist interface.

How to use todoist-mcp-server?

There are two primary ways to install and use todoist-mcp-server:

Installing via Smithery

For automatic installation with Claude Desktop, use the following command:

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

Manual Installation

To install manually, run:

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

Setup with Claude Desktop

1. Obtain your Todoist API Token from Todoist Settings → Integrations → Developer.
2. Add the following configuration 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

Once set up, you can interact with Todoist through Claude using natural language. Here are some examples:

• Creating Tasks: "Create task 'Team Meeting'", "Add task 'Review PR' due tomorrow at 2pm"
• Getting Tasks: "Show all my tasks", "List tasks due today", "Get high priority tasks"
• Updating Tasks: "Update documentation task to be due next week", "Change priority of bug fix task to urgent"
• Completing Tasks: "Mark the PR review task as complete"
• Deleting Tasks: "Delete the PR review task"

Key Features of todoist-mcp-server

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

Use Cases of todoist-mcp-server

• Hands-free Task Management: Quickly add or modify tasks while busy with other activities.
• Streamlined Workflow: Integrate task management directly into your AI assistant interactions.
• Efficient Task Retrieval: Easily find specific tasks using natural language queries.
• Voice-controlled Productivity: Manage your Todoist tasks using voice commands through Claude.

FAQ from todoist-mcp-server

• What is an MCP server? An MCP (Model Context Protocol) server facilitates communication between AI models (like Claude) and external applications (like Todoist).
• How do I get my Todoist API token? Log in to your Todoist account, go to Settings → Integrations, and find your API token under "Developer".
• Can I filter tasks by project? Yes, the todoist_get_tasks tool allows filtering by project.
• What priority levels are supported? Priority levels range from 1 to 4, with 1 being the highest priority.

Todoist MCP Server

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

Features

• Natural Language Task Management: Create, update, complete, and delete tasks using everyday language
• Smart Task Search: Find tasks using partial name matches
• Flexible Filtering: Filter tasks by due date, priority, and other attributes
• Rich Task Details: Support for descriptions, due dates, and priority levels
• Intuitive Error Handling: 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

Create new tasks with various attributes:

• Required: content (task title)
• Optional: description, due date, priority level (1-4)
• Example: "Create task 'Team Meeting' with description 'Weekly sync' due tomorrow"

todoist_get_tasks

Retrieve and filter tasks:

• Filter by due date, priority, or project
• Natural language date filtering
• Optional result limit
• Example: "Show high priority tasks due this week"

todoist_update_task

Update existing tasks using natural language search:

• Find tasks by partial name match
• Update any task attribute (content, description, due date, priority)
• Example: "Update meeting task to be due next Monday"

todoist_complete_task

Mark tasks as complete using natural language search:

• Find tasks by partial name match
• Confirm completion status
• Example: "Mark the documentation task as complete"

todoist_delete_task

Remove tasks using natural language search:

• Find and delete tasks by name
• Confirmation messages
• Example: "Delete the PR review task"

Setup

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.