📌Overview

Purpose: To provide a natural language interface for managing tasks in Todoist through the MCP server integration with Claude.

Overview: The Todoist MCP Server is an implementation of the Model Context Protocol (MCP) that enables seamless interaction with Todoist using everyday language. It allows users to effectively create, update, and manage tasks, enhancing the productivity and task management experience.

Key Features:

Natural Language Task Management: Users can create, update, complete, and delete tasks using simple language, making task management intuitive and user-friendly.
Smart Task Search: The server supports finding tasks through partial name matches, allowing users to easily locate tasks even if they don't remember the exact name.
Flexible Filtering: Users can filter tasks by various attributes such as due dates and priority levels, providing a tailored view of tasks.
Rich Task Details: The server supports detailed task information, including descriptions, due dates, and priority levels, enabling better task organization.
Intuitive Error Handling: The system offers clear feedback during interactions, contributing to a better user experience.

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

Log in to your Todoist account
Navigate to Settings → Integrations
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:
https://github.com/abhiz123/todoist-mcp-server/issues