Todoist Integration MCP Server

Developer ToolsTypeScript

Natural language task management for Todoist

Available Tools

todoist_create_task

Creates a new task in Todoist with specified content, optional description, due date, and priority level (1-4)

todoist_get_tasks

Retrieves and filters tasks by due date, priority, or project with natural language date filtering and optional result limit

todoist_update_task

Updates existing tasks using natural language search, allowing changes to content, description, due date, or priority

todoist_complete_task

Marks tasks as complete using natural language search to find tasks by partial name match

todoist_delete_task

Removes tasks using natural language search to find and delete tasks by name

Todoist Integration enables Claude to interact with your Todoist tasks using natural language. This powerful integration allows you to create, update, complete, and delete tasks through conversational commands, making task management more intuitive and efficient. With features like smart task search, flexible filtering by due date and priority, and rich task details support, this integration transforms how you organize your work. The server handles all the complexity of translating your natural language requests into precise Todoist API calls.

Overview

The Todoist Integration allows Claude to manage your Todoist tasks using natural language. This integration bridges the gap between conversational AI and your task management system, enabling you to organize your work more efficiently through simple, human-like interactions.

Setup Requirements

Before using this integration, you'll need:

A Todoist account
Your Todoist API token (found in Todoist Settings → Integrations → Developer)

Installation

Automatic Installation via Smithery

The easiest way to install the Todoist integration is through Smithery:

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

This command will automatically configure the integration for Claude Desktop.

Manual Installation

Install the package globally:

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

Configure your Claude Desktop by editing the claude_desktop_config.json file to include:

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

Replace your_api_token_here with your actual Todoist API token.

Usage Examples

Once installed, you can interact with your Todoist tasks using natural language. Here are some examples of what you can do:

Creating Tasks

"Create a task to review the quarterly report"
"Add a high priority task to fix the website bug due tomorrow at 3pm"
"Create a task for team meeting with description 'Discuss project timeline' due next Tuesday"

Viewing Tasks

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

Updating Tasks

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

Completing Tasks

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

Deleting Tasks

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

Advanced Usage

Filtering Tasks

You can use natural language to filter tasks by various attributes:

Due date: "Show tasks due this week/month/today"
Priority: "Show high/medium/low priority tasks"
Combinations: "Show high priority tasks due this week"

Task Search

The integration uses smart partial matching to find tasks by name, so you don't need to remember the exact task title.

Troubleshooting

If you encounter issues:

Verify your Todoist API token is correct
Ensure you have an active internet connection
Check that the task you're trying to modify exists
For more detailed help, visit the GitHub repository

Building from Source

If you want to modify or contribute to the integration:

git clone https://github.com/abhiz123/todoist-mcp-server.git
cd todoist-mcp-server
npm install
npm run build