Install Todoist MCP

Pick your client, copy the command, done.

Manual setup required. The maintainer's config contains paths only you know — edit the placeholders below before adding it to Claude Code.

Run this once before adding it to Claude Code.

git clone https://github.com/kpanko/todoist-mcp
cd todoist-mcp
cp .env.example .env
uv sync

claude mcp add -e "TODOIST_API_TOKEN=${TODOIST_API_TOKEN}" todoist-mcp -- uv --project /path/to/todoist-mcp run todoist-mcp

Replace any placeholder paths in the command with the real path on your machine.

Required:TODOIST_API_TOKEN

Environment Variables

Set these before running Todoist MCP.

VariableDescriptionRequired

TODOIST_API_TOKENTodoist API token from Settings -> IntegrationsYes

Once configured, Todoist MCP gives your AI agent access to:

get_taskFetch a single task by ID

find_tasksFilter tasks by Todoist query string, project, or label

find_tasks_by_dateTasks due on or between dates

get_projectsList all projects

get_sectionsList sections in a project

get_commentsGet comments on a task

get_overviewOverdue + today summary, or all tasks in a project

add_taskCreate a task (supports due_string, priority, labels)

update_taskUpdate content, description, priority, or labels

complete_taskMark a task done

add_projectCreate a project

add_sectionCreate a section

add_commentAdd a comment to a task

reschedule_taskMove a task to a new date, safely preserving recurring patterns and reminders

After setup, try these prompts with your AI agent:

→What are my overdue tasks and what do I have on my plate for today?

→Reschedule the 'Finish project report' task to next Monday while keeping its recurring schedule.

→Find all tasks in the 'Work' project that have the 'urgent' label.

→Add a new task 'Buy groceries' to the 'Personal' project with high priority.

→List all comments on the task with ID 123456789.

Save the docs, env vars, and workflow around Todoist MCP in Conare so Claude Code, Codex, and Cursor remember it next time.