Skip to main content
Glama
A-J-C

Todoist MCP Server

by A-J-C
OverviewSchemaRelated ServersScoreDiscussions
TypeScript

Todoist MCP Server

A Model Context Protocol (MCP) server for the Todoist API v1. Provides 44 tools with read-only/write annotations so Claude Desktop groups them correctly.

Install in Claude Desktop (recommended)

Download or build todoist-mcp-server.mcpb, then double-click it (or drag it into Claude Desktop → Settings → Extensions). Claude Desktop will prompt for your Todoist API Token during install.

Get your API token from: https://app.todoist.com/app/settings/integrations/developer

Build the .mcpb from source

Requires just (brew install just):

just bundle

That installs deps, compiles, stages a clean dependency tree, and packs todoist-mcp-server.mcpb at the repo root. Other recipes: just build, just run, just clean. Run just with no args to list them all.

Related MCP server: Todoist MCP

Manual configuration (alternative)

If you'd rather wire up the server directly without packaging:

just build

Create a .env file:

TODOIST_API_TOKEN=your_todoist_api_token_here

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "todoist": {
      "command": "node",
      "args": ["/path/to/todoist-mcp-server/dist/index.js"],
      "env": {
        "TODOIST_API_TOKEN": "your_token_here"
      }
    }
  }
}

Tools (44 total)

Read-only (22)

Tool

Description

find-tasks-by-date

Find tasks by due date range

fetch

Fetch any Todoist API URL directly

fetch-object

Get a specific object by type and ID

find-activity

Recent activity (completed tasks)

find-comments

Comments on tasks or projects

find-completed-tasks

Completed tasks with date filtering

find-filters

User-defined filters (guidance — managed via app)

find-labels

Personal labels

find-project-collaborators

Project collaborators

find-projects

All projects

find-reminders

All reminders

find-sections

Sections (optionally by project)

find-tasks

Active tasks with filtering

get-overview

Workspace overview with task counts

get-productivity-stats

Karma, streaks, daily/weekly trends

get-project-activity-stats

Completed tasks for a project

get-project-health

Project health analysis

get-workspace-insights

Cross-workspace analytics

list-workspaces

User account and workspace info

search

Search tasks by content, description, or label

user-info

Authenticated user details

view-attachment

View comment attachments

analyze-project-health

Deep project health analysis with suggestions

Write (19)

Tool

Description

add-comments

Add comments to tasks/projects

add-filters

Create filters (guidance — managed via app)

add-labels

Create personal labels

add-projects

Create projects

add-reminders

Add task reminders (requires Pro)

add-sections

Create project sections

add-tasks

Create tasks with subtasks, labels, priorities, due dates

complete-tasks

Mark tasks complete

manage-assignments

Assign/unassign tasks in shared projects

project-management

Bulk project update/delete

project-move

Reposition a project by order

reorder-objects

Reorder tasks, projects, or sections

reschedule-tasks

Bulk reschedule task due dates

uncomplete-tasks

Reopen completed tasks

update-comments

Update comment content

update-filters

Update filters (guidance — managed via app)

update-projects

Update project properties

update-reminders

Update reminder settings

update-sections

Update section names

update-tasks

Update tasks (including move between sections/projects)

Destructive (1)

Tool

Description

delete-object

Delete any object (task, project, section, comment, label)

API Coverage

Uses the Todoist API v1 (https://api.todoist.com/api/v1/). Handles paginated responses automatically.

Resource

Read

Create

Update

Delete

Move

Tasks

Yes

Yes

Yes

Yes

Yes

Projects

Yes

Yes

Yes

Yes

Yes (reorder)

Sections

Yes

Yes

Yes

Yes

—

Comments

Yes

Yes

Yes

Yes

—

Labels

Yes

Yes

Yes

Yes

—

Reminders

Yes

Yes

Yes

—

—

Completed tasks

Yes

—

—

—

—

Productivity stats

Yes

—

—

—

—

User info

Yes

—

—

—

—

Collaborators

Yes

—

—

—

—

Notes

  • Filters: The Todoist API v1 does not expose filter CRUD. The add-filters/update-filters tools return guidance to use the Todoist app. Use find-tasks with parameters for filter-like behavior.

  • Reminders: Require Todoist Pro plan. The tools work correctly but will return HTTP 403 on free accounts.

  • Tool annotations: All tools include readOnlyHint/destructiveHint so Claude Desktop groups them into read-only, write, and destructive categories.

This server cannot be installed

F
license - not found
-
quality - not tested
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
0dRelease cycle
3Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/A-J-C/todoist-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server