Todoist

This MCP server provides secure, programmatic access to manage Todoist tasks, projects, comments, and labels via a structured API. You can perform full CRUD operations and interact with Todoist data through an MCP client, enabling automated workflows and natural language commands to orchestrate your Todoist workspace.

How to use

You connect an MCP client to the Todoist MCP Server to perform create, read, update, and delete operations on tasks, projects, comments, and labels. Use the available tools to create new items, list and filter existing ones, fetch detailed information, modify attributes, and remove items when needed. You can combine multiple actions to build end-to-end workflows, such as creating a task, assigning labels, and setting a due date, then later updating or completing that task.

How to install

Prerequisites you need to prepare before running the server include a Python runtime and an API token for Todoist. You will also ensure you can run the server locally with Python.

Step-by-step commands to set up and run the server locally.

# Step 1: Install Python (if not already installed)
# Step 2: Create a working directory and place the server script there
# Step 3: Set your Todoist API token as an environment variable
export TODOIST_API_TOKEN="YOUR_API_TOKEN"

# Step 4: Run the Todoist MCP Server directly with Python
python todoist_server.py

# Optional: Test the MCP interface by sending a request (example shown for testing)
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | python todoist_server.py

Additional sections

Configuration and security considerations are important when running the server. All credentials should be stored securely and never logged. The token you use grants access to Todoist data, so protect it and limit exposure. The server is designed to operate over secure communications and to run in a controlled environment.

Available tools

create_task

Create a new task with content, description, due date, priority, and labels.

list_tasks

List all tasks with optional filters such as project, label, or custom criteria.

get_task

Retrieve detailed information about a specific task.

update_task

Update task content, description, due date, priority, or labels.

complete_task

Mark a task as completed.

reopen_task

Reopen a completed task.

delete_task

Permanently delete a task.

create_project

Create a new project with name, color, favorite status, and view style.

list_projects

List all projects in your Todoist account.

get_project

Get detailed information about a specific project.

update_project

Update project name, color, favorite status, or view style.

delete_project

Permanently delete a project.

create_comment

Add comments to tasks.

list_comments

List all comments for a task or project.

create_label

Create new labels with a name and color.

list_labels

List all labels in your account.