How to connect Todoist MCP to Claude

Connect Claude Web, Desktop and Cowork to Todoist MCP. Create project q3 roadmap and tasks, list all overdue tasks assigned to me, and more using natural language, with authentication handled for you.

Get started for free Get a demo

Todoist MCP

Dcr Oauth

Todoist MCP is a hosted Streamable HTTP server for Todoist that exposes task and project operations. Use it to let AI agents integrate with Todoist without writing bespoke integration code.

47 Tools

Managed auth

Connect Todoist MCP without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Book a call

Explore the MCP Gateway

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Todoist account to Claude via Composio Connect, enabling it to create project Q3 roadmap and tasks, list all overdue tasks assigned to me, complete today's high priority tasks in Inbox, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Todoist MCP with

ChatGPT Work Hermes

Connecting Todoist to Claude Web, Desktop, and Cowork

1. Open Customize

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

2. Add the Composio MCP server

Click Add custom connector and paste in the Composio MCP server URL:

bash

https://connect.composio.dev/mcp

Add custom connector dialog with Composio MCP server URL

3. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

4. Connect your Todoist account

Back in Claude, ask it to connect to Todoist or give it any Todoist-related task.

For example, ask Claude to:

"Create project Q3 roadmap and tasks"
"List all overdue tasks assigned to me"
"Complete today's high priority tasks in Inbox"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Todoist account is ready to use.

What is the Todoist Claude Connector, and what's possible with it?

The Todoist MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Todoist account. It provides structured and secure access so your agent can perform Todoist operations on your behalf.

Troubleshooting

1. Why does Claude not use the Composio connector for Todoist?

The connector can show as connected, but Claude must use it in each Todoist conversation.

Click + at the lower left of the chat, or type /.
Hover Connectors.
Turn on Composio.
Ask Claude to connect to Todoist again.

2. Why does Claude show an MCP server error before Todoist connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Todoist.

Check that the connector URL is https://connect.composio.dev/mcp.
Connectors run from Anthropic's cloud, so your device network is usually not the problem.
Add the connector again from Customize > Connectors, then ask Claude to connect Todoist.
If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Todoist authorization link not work?

The Composio connector is one server. Your Todoist account connects separately when Claude asks for it.

If the browser does not open, or the link expires, ask Claude to retry the Todoist connection.
Composio creates a fresh Todoist authorization link.
Open that link in your browser and finish the Todoist sign-in.

4. Why do Todoist actions fail after they worked before?

The Todoist connection can expire or lose permission.

Ask Claude to inspect the Todoist connection.
If the connection is unhealthy, disconnect it when Claude prompts you.
Reconnect the Todoist account and retry the action.
If Claude shows a permission prompt, approve it before Claude changes data in Todoist.
If the action still fails with a permission error, check that the connected account has that permission in Todoist itself.

5. How do I switch to a different Todoist account?

Claude can manage the Todoist connection for you.

Ask Claude to disconnect or delete the current Todoist account.
Ask Claude to connect Todoist again.
Open the new Composio authorization link for Todoist.
Sign in with the other Todoist account in the browser.
After the account connects, ask Claude to retry the Todoist task.

6. Why is my Todoist connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Todoist connection works in Claude Web, Desktop, and Cowork.

In Claude Desktop, open Customize > Connectors.
Next to Composio, click ⋮ and click Clear cache.
If Todoist tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Todoist.

TOOLS

Supported Tools

Every Todoist MCP action and event your agent gets out of the box.

Add-comments

Add multiple comments to tasks or projects, optionally notifying collaborators.

Add-filters

Add one or more new personal filters.

Add-labels

Add one or more new personal labels.

Add-projects

Add one or more new projects.

Add-reminders

Add reminders to tasks.

Add-sections

Add one or more new sections to projects.

Add-tasks

Add one or more tasks to a project, section, or parent.

Analyze-project-health

Trigger a new health analysis for a project.

Complete-tasks

Complete one or more tasks by their IDs.

Delete-object

Delete a project, section, task, comment, label, filter, reminder, or location_reminder by its ID.

Export-project-template

Export an existing project as a Todoist template, either as CSV content or as a shareable URL.

Fetch

Fetch the full contents of a task or project by its ID.

Fetch-object

Fetch a single task, project, comment, or section by its ID.

Find-activity

Retrieve activity logs to monitor and audit changes in Todoist.

Find-comments

Find comments by task, project, or get a specific comment by ID.

Find-completed-tasks

Get completed tasks in a date range.

Find-filters

List all personal filters or search for filters by name.

Find-labels

List personal labels and shared labels.

Find-project-collaborators

Find Todoist users (collaborators, teammates) by name or email to look up their user ID.

Find-projects

List all projects or search for projects by name.

Find-reminders

Find reminders by task ID (returns all reminder types), or get a specific reminder by its ID.

Find-sections

Search for sections by name or other criteria in a project.

Find-tasks

Find tasks by text search, project/section/parent container, responsible user, labels, a raw Todoist filter string, or a saved filter by ID or name (filterIdOrName).

Find-tasks-by-date

Get tasks by date range.

Get-overview

Get a Markdown overview.

Get-productivity-stats

Get comprehensive productivity statistics including daily/weekly completion breakdowns, goal streaks (current, last, max), karma score and trends, and historical karma data.

Get-project-activity-stats

Get daily and optional weekly task completion counts for a project over a configurable time window (1-12 weeks).

Get-project-health

Get a comprehensive health assessment for a project including completion progress, health status (EXCELLENT, ON_TRACK, AT_RISK, CRITICAL), and optional detailed context with project metrics and task-level data.

Get-workspace-insights

Get aggregated health and progress insights across all projects in a workspace.

Import-project-template

Import a template into an existing project, adding its tasks, sections and comments to whatever is already there.

List-workspaces

Get all workspaces for the authenticated user.

Manage-assignments

Bulk assignment operations for multiple tasks.

Project-management

Archive or unarchive a project by its ID.

Project-move

Move a project between personal and workspace contexts.

Reorder-objects

Reorder sibling projects or sections, and optionally move projects to a new parent.

Reschedule-tasks

Reschedule tasks to new dates while preserving recurring schedules.

Search across tasks and projects in Todoist.

Uncomplete-tasks

Uncomplete (reopen) one or more completed tasks by their IDs.

Update-comments

Update multiple existing comments with new content.

Update-filters

Update one or more existing personal filters with new values.

Update-labels

Update one or more existing labels.

Update-projects

Update multiple existing projects with new values.

Update-reminders

Update existing reminders.

Update-sections

Update multiple existing sections with new values.

Update-tasks

Update existing tasks including content, dates, priorities, and assignments.

User-info

Get comprehensive user information including user ID, full name, email, timezone with current local time, week start day preferences, current week dates, daily/weekly goal progress, and user plan (Free/Pro/Business).

View-attachment

View a file attachment from a Todoist comment.

FRAMEWORKS

How to build Todoist MCP Agent with another framework

ChatGPT Work

Use Todoist MCP with ChatGPT Work

Hermes

Use Todoist MCP with Hermes

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Google Sheets

Oauth2

Google Sheets is a cloud-based spreadsheet tool for real-time collaboration and data analysis. It lets teams work together from anywhere, updating information instantly.

Notion

Oauth2Api Key

Notion is a collaborative workspace for notes, docs, wikis, and tasks. It streamlines team knowledge, project tracking, and workflow customization in one place.

Airtable

Oauth2Api Key

Airtable combines the flexibility of spreadsheets with the power of a database for easy project and data management. Teams use Airtable to organize, track, and collaborate with custom views and automations.

Asana

Oauth2

Asana is a collaborative work management platform for teams to organize and track projects. It streamlines teamwork, boosts productivity, and keeps everyone aligned on goals.

FAQ

Frequently asked questions

With a standalone Todoist MCP server, the agents and LLMs can only access a fixed set of Todoist tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Todoist and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Todoist tools.

Yes, absolutely. You can configure which Todoist scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Todoist data and credentials are handled as safely as possible.

Start with Todoist MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Todoist MCP tool your agent needs.Free to start.

Start building