todoist-mcp

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides full access to the Todoist REST API v2, enabling task management (create, update, close, reopen, delete), project management, section handling, comment management for tasks and projects, and label management through natural language interactions.

特征

完整的 Todoist API 集成：访问完整的 Todoist REST API v2，并通过自然语言支持 Todoist Sync API
批处理：客户端可以在单个请求中处理多个任务
按名称搜索：AI 可以按名称而不是 ID 搜索任务、项目和标签
任务：使用对话语言创建、更新、关闭、重新打开、移动和删除任务
项目：创建和管理项目和部分
评论：添加和管理任务和项目的评论
标签：创建和管理个人和共享标签
及时支持：您可以轻松地向客户提供有关您的项目的信息

配置

您需要一个 Todoist API 令牌才能使用此 MCP 服务器。

获取 Todoist API 令牌

登录您的 Todoist 帐户
导航至“设置”→“集成”
在“开发者”下找到您的 API 令牌

与 Claude Desktop 一起使用

添加到您的claude_desktop_config.json ：

{
    "mcpServers": {
        "todoist": {
            "command": "npx",
            "args": ["-y", "todoist-mcp"],
            "env": {
                "API_KEY": "your_todoist_api_token_here"
            }
        }
    }
}

可用工具

任务

get_tasks_list ：获取任务，并可按项目、部分、标签等进行可选过滤。
create_tasks ：创建具有各种属性的新任务
get_tasks ：通过 ID 或名称获取特定任务
update_tasks ：更新现有任务
close_tasks ：将任务标记为完成
reopen_tasks ：重新打开已完成的任务
delete_tasks ：删除任务
move_tasks ：将任务移动到不同的项目或部分

项目

get_projects_list ：获取所有项目
create_projects ：创建新项目
get_projects ：通过 ID 或名称获取特定项目
update_projects ：更新现有项目
delete_projects ：删除项目
get_collaborators ：获取项目的所有合作者
move_projects ：将项目移动到其他位置或子项目

章节

get_sections_list ：获取所有部分或按项目过滤
create_sections ：创建新部分
get_sections ：通过 ID 或名称获取特定部分
update_sections ：更新部分
delete_sections ：删除部分

get_labels_list ：获取所有个人标签
create_labels ：创建新的个人标签
get_labels ：通过 ID 或名称获取个人标签
update_labels ：更新个人标签
delete_labels ：删除个人标签
get_shared_labels ：获取所有共享标签
rename_shared_labels ：重命名共享标签
remove_shared_labels ：删除共享标签

实用程序

utils_get_colors ：获取项目、标签、过滤器可用的颜色

提示

projects_list ：获取 markdown 格式的项目列表及其部分和参数

示例用法

向你的人工智能助手（如 Claude）询问以下问题：

"What tasks do I have due today?"
"Create a task to review the quarterly report by next Friday"
"Make a new project called 'Home Renovation'"
"Add a comment to my meeting prep task"
"Show me all my high priority tasks"
"Create a label for 'Urgent' tasks with a red color"
"What projects do I have in my Todoist?"
"Mark my dentist appointment task as complete"

发展

# Install dependencies
npm install

# Build the project and run inspector
npm run build && npx @modelcontextprotocol/inspector -e API_KEY=YOUR_API_KEY_HERE node dist/index.js

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

问题与支持

如果您遇到任何问题或需要支持，请在 GitHub 存储库上提交问题。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

完成 Todoist REST API v2 并支持 Todoist Sync API 集成，支持任务、项目、部分、评论和标签管理