Todoist MCP Server

19 forks

84 stars

Free

What is todoist-mcp-server

todoist-mcp-server is a powerful server implementation developed by abhiz123 that seamlessly integrates the AI capabilities of Claude with the popular task management tool, Todoist. This server harnesses the Model Context Protocol (MCP) to enable users to manage their Todoist tasks using natural language. By doing so, it simplifies task management, allowing users to create, update, complete, and delete tasks using everyday language instead of complex commands.

How to Use todoist-mcp-server

Using todoist-mcp-server is straightforward, making task management more intuitive and efficient. To begin, you can install the server either automatically via Smithery or manually through npm. Once installed, the server can interpret your natural language inputs and perform various task-related operations within Todoist.

Installation

Automatic Installation via Smithery: Use the command line to install the server with the Smithery CLI.
Manual Installation: Simply run the npm installation command to get started.

After installation, ensure you have your Todoist API token ready, which can be obtained from your Todoist account settings. This token allows the server to access and manage your Todoist tasks.

Configuration

To use the server with Claude Desktop, you need to add specific configurations to your claude_desktop_config.json file. Include the server command, arguments, and your Todoist API token for seamless integration.

Key Features of todoist-mcp-server

todoist-mcp-server offers a range of features designed to enhance your task management experience:

Natural Language Task Management: Easily create, update, complete, and delete tasks using simple, natural language commands. This makes task management accessible and efficient.
Smart Task Search: Quickly find tasks using partial name matches. This feature saves time and improves productivity by allowing you to locate tasks without needing to remember exact names.
Flexible Filtering: Filter tasks based on various attributes such as due date and priority, allowing for more organized task management.
Rich Task Details: Add comprehensive details to tasks, including descriptions, due dates, and priority levels, ensuring you have all necessary information at your fingertips.
Intuitive Error Handling: Experience clear feedback for any errors, enhancing the overall user experience and reducing the learning curve.

Task Management Tools

todoist_create_task: Easily create tasks with attributes like content, description, due date, and priority.
todoist_get_tasks: Retrieve tasks by filtering based on criteria like due date and priority.
todoist_update_task: Update task attributes using natural language, facilitating quick adjustments.
todoist_complete_task: Mark tasks as complete with simple commands.
todoist_delete_task: Remove tasks efficiently using natural language search.

With these features and tools, todoist-mcp-server not only integrates AI into task management but also enhances the way you interact with your tasks, making it a valuable addition to any productivity toolkit.

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

To install Todoist MCP Server for Claude Desktop automatically via :

npx -y @/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 
# 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.

How to Use

To use the todoist-mcp-server, follow these steps:

Visit https://github.com/abhiz123/todoist-mcp-serverhttps://github.com/abhiz1...
Follow the setup instructions to create an account (if required)
Connect the MCP server to your Claude Desktop application
Start using todoist-mcp-server capabilities within your Claude conversations

Additional Information

Created

December 3, 2024

Company

abhiz123

Related MCP Servers

Start building your own MCP Server

Interested in creating your own MCP Server? Check out the official documentation and resources.

Learn More

Todoist MCP Server

What is todoist-mcp-server

How to Use todoist-mcp-server

Installation

Configuration

Key Features of todoist-mcp-server

Task Management Tools

Features

Installation

Installing via

Manual Installation

Tools

todoist_create_task

todoist_get_tasks

todoist_update_task

todoist_complete_task

todoist_delete_task

Setup

Getting a Todoist API Token

Usage with Claude Desktop

Example Usage

Creating Tasks

Getting Tasks

Updating Tasks

Completing Tasks

Deleting Tasks

Development

Building from source

Contributing

License

Issues and Support

How to Use

Additional Information

Created

Company

Related MCP Servers

Claude Plus

Wcgw

Claude Project Terminal

Start building your own MCP Server