Todoist MCP Server

Todoist MCP Server

Natural language Todoist management for Claude via MCP.

View on GitHub
323
Stars
63
Forks
323
Watchers
15
Issues
Todoist MCP Server enables integration of Claude with Todoist, allowing users to manage their tasks using natural language commands. It implements the Model Context Protocol (MCP), providing tools for creating, updating, completing, and deleting tasks through conversational input. The server supports smart search, flexible filtering, and rich task attribute handling, aiming to streamline task management with intuitive error feedback.

Key Features

Natural language creation, update, completion, and deletion of tasks
Smart task search with partial name matching
Filtering tasks by due date, priority, and project
Rich handling of task attributes such as descriptions and priorities
Seamless integration with Claude Desktop via MCP
Intuitive error handling and confirmation messaging
Manual and automated installation options
Support for environment variable configuration (API token)
Clear example usage scenarios in natural language
Smithery and manual installation support

Use Cases

Creating new Todoist tasks using casual or conversational language
Retrieving high-priority or time-sensitive tasks for review
Updating deadlines or descriptions on existing tasks through chat
Automatically marking tasks as complete based on natural language commands
Deleting tasks by mentioning their names naturally in conversation
Filtering tasks due today, this week, or by project for daily planning
Integrating advanced task management into Claude Desktop for AI assistant use
Providing automated, error-tolerant feedback when task operations fail
Rapid onboarding for natural language-based productivity workflows
Enhancing productivity tools with voice or text-based Todoist command handling

README

Todoist MCP Server

smithery badge

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:

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

Manual Installation

bash
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:

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

bash
# 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.

Star History

Star History Chart

Repository Owner

abhiz123
abhiz123

User

Repository Details

Language JavaScript
Default Branch main
Size 9 KB
Contributors 4
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

JavaScript
100%

Tags

Natural Language Processing Task Management automation contextual search

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Things MCP Server

    Things MCP Server

    Seamless Model Context Protocol integration for managing Things app todos and projects.

    Things MCP Server enables AI assistants to interact with the Things productivity app using the Model Context Protocol (MCP). It offers comprehensive support for Things' URL scheme, allowing creation, updating, and management of todos and projects through standardized commands. The server supports batch operations, advanced organization features, and natural language scheduling, making task automation efficient for MCP-compatible clients.

    • ⭐ 6
    • MCP
    • jimfilippou/things-mcp
  • Notion MCP Integration

    Notion MCP Integration

    Integrate your minimal Notion todo list with Claude via Model Context Protocol.

    Notion MCP Integration provides a simple MCP server that enables users to manage a minimalist Notion todo list through Claude, leveraging Notion's API. It supports adding, viewing, and completing tasks according to a specific Notion database structure. Designed for personal use, it allows users to interact with their tasks using natural language through Claude Desktop. The tool is easily customizable for different Notion databases by modifying the server implementation.

    • ⭐ 202
    • MCP
    • danhilse/notion_mcp
  • notion-mcp

    notion-mcp

    An MCP server for managing Notion to-do lists via API integration.

    notion-mcp provides a Model Context Protocol (MCP) server that connects with Notion's API to help users manage their personal to-do lists. It enables querying, adding, and updating tasks directly from Notion through a standardized MCP interface, and is designed for integration with tools like Claude Desktop. The project is set up for easy deployment via Smithery and supports OAuth credentials and per-user configuration.

    • ⭐ 27
    • MCP
    • Badhansen/notion-mcp
  • TaskWarrior MCP Server

    TaskWarrior MCP Server

    MCP server for managing TaskWarrior tasks via a standardized protocol

    Implements the Model Context Protocol (MCP) to provide a Node.js server interface for TaskWarrior operations. Allows viewing, filtering, adding, and completing tasks through a standardized API. Integrates with task management workflows by utilizing the local TaskWarrior client, supporting advanced task attributes like projects and tags. Enables seamless task manipulation for external tools such as Claude Desktop.

    • ⭐ 36
    • MCP
    • awwaiid/mcp-server-taskwarrior
  • MCP Manager for Claude Desktop

    MCP Manager for Claude Desktop

    A desktop app to manage Model Context Protocol (MCP) servers for Claude Desktop on MacOS.

    MCP Manager for Claude Desktop provides a user-friendly interface to manage Model Context Protocol (MCP) servers, enabling Claude to access private data, APIs, and local or remote services securely from a MacOS desktop. It facilitates rapid configuration and integration with a wide variety of MCP servers, including productivity tools, databases, and web APIs. The app runs locally to ensure data privacy and streamlines connecting Claude to new sources through simple environment and server settings management.

    • ⭐ 270
    • MCP
    • zueai/mcp-manager
  • TickTick MCP

    TickTick MCP

    MCP server for AI-powered TickTick task management integration

    TickTick MCP is a Model Context Protocol (MCP) server that enables standardized integration of TickTick's task management features with AI assistants and developer applications. It allows programmatic access to create, update, retrieve, complete, or delete tasks and projects in TickTick via Python. Using this MCP server, AI systems can leverage TickTick's API to help automate and manage user's to-do lists and projects through natural language or other interfaces.

    • ⭐ 6
    • MCP
    • ekkyarmandi/ticktick-mcp
    • View all Alternatives

    Didn't find tool you were looking for?

    Be as detailed as possible for better results