Todoist Mcp Server

Overview

What is Todoist MCP Server?

The ### Todoist MCP Server is an innovative integration solution designed to enhance the functionality of Todoist, a popular task management application. This server enables users to manage their tasks using natural language processing, allowing for a more intuitive and efficient task management experience. By leveraging Claude, a powerful AI, the Todoist MCP Server transforms the way users interact with their task lists, making it easier to add, modify, and track tasks through simple conversational commands.

Features of Todoist MCP Server

Natural Language Processing: The server utilizes advanced NLP techniques to understand user commands, making task management as simple as speaking or typing in plain language.
Seamless Integration: It integrates smoothly with Todoist, allowing users to access all their existing tasks and projects without any hassle.
Real-time Updates: Users can receive instant feedback and updates on their tasks, ensuring they are always informed about their task status.
User-friendly Interface: The server is designed with usability in mind, providing a straightforward interface that is easy to navigate for users of all skill levels.
Open Source: Being a public repository, developers can contribute to the project, enhancing its features and capabilities over time.

How to Use Todoist MCP Server

Installation: Begin by cloning the repository from GitHub. Use the command:
```
git clone https://github.com/abhiz123/todoist-mcp-server.git
```
Setup: Follow the setup instructions provided in the repository to configure the server with your Todoist account.
Start the Server: Launch the server using the command line, ensuring that all dependencies are installed.
Interact with the Server: Use natural language commands to add, update, or delete tasks. For example, you can say, "Add a task to buy groceries tomorrow at 5 PM."
Monitor Your Tasks: Check the server's output for real-time updates on your tasks and their statuses.

Frequently Asked Questions

What programming languages are used in Todoist MCP Server?

The Todoist MCP Server is primarily built using JavaScript and Node.js, which are commonly used for server-side applications.

Is Todoist MCP Server free to use?

Yes, the Todoist MCP Server is open-source and free to use. You can download and modify it as per your needs.

Can I contribute to the Todoist MCP Server?

Absolutely! Contributions are welcome. You can fork the repository, make your changes, and submit a pull request for review.

What are the system requirements for running the server?

The server requires Node.js and npm installed on your machine. Ensure your system meets the minimum requirements for these tools.

How can I report issues or bugs?

You can report issues by opening an issue in the GitHub repository. Provide detailed information about the problem to help the developers address it effectively.

By utilizing the Todoist MCP Server, users can significantly enhance their productivity and streamline their task management processes through the power of natural language processing.

Details

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.

{ "mcpServers": { "todoist-mcp-server": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/metorial/mcp-container--abhiz123--todoist-mcp-server--todoist-mcp-server", "node dist/index.js" ], "env": { "TODOIST_API_TOKEN": "todoist-api-token" } } } }