AI导哈

任务管理AI集成服务

一个将Claude等AI助手与Todoist集成的模型上下文协议服务器，支持自然语言任务管理。

  • by stanislavlysenko0912
  • TypeScript
  • 本地部署
  • 63 星标
  • 更新于
在 GitHub 查看 stanislavlysenko0912/todoist-mcp-server

使用说明

Todoist MCP Server

A Model Context Protocol (MCP) server implementation that integrates Claude and other AI assistants with Todoist, enabling natural language task management.

特性

  • 完成Todoist API集成：访问完整的Todoist REST API v2，并通过自然语言支持Todoist Sync API
  • 批处理：客户端可以在单个请求中处理多个任务
  • 按名称搜索：AI可以按名称而不是ID搜索任务、项目和标签
  • 任务：使用会话语言创建、更新、关闭、重新打开、移动和删除任务
  • 项目：创建和管理项目和部门
  • 评论：添加和管理对任务和项目的评论
  • 标签：创建和管理个人和共享标签
  • 智能上下文：启动时，通过服务器指令自动向AI提供您的项目和标签，无需额外的工具调用
  • 快速支持：您可以轻松地向客户提供有关项目的信息

配置

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

获取Todoist API代币

  1. 登录您的Todoist帐户
  2. 导航到“设置”→ 集成
  3. 在“开发者”下找到您的API代币

用法

添加 mcpServers 在您的平台配置中：

"todoist": {
    "command": "npx",
    "args": ["-y", "todoist-mcp"],
    "env": { "API_KEY": "your_todoist_api_token" }
}
平台 配置
克劳德桌面 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）， %APPDATA%\Claude\ （Windows）
克劳德代码 .mcp.json — claude mcp add --transport stdio --scope project --env API_KEY=token todoist -- npx -y todoist-mcp
光标 ~/.cursor/mcp.json 或 .cursor/mcp.json
食品法典委员会 ~/.codex/config.toml 或 .codex/config.toml --请参阅下面的示例
Gemini CLI ~/.gemini/settings.json — gemini mcp add -e API_KEY=token todoist npx -y todoist-mcp

法典 --CLI：

codex mcp add todoist --env API_KEY=your_token -- npx -y todoist-mcp

或添加到 config.toml:

[mcp_servers.todoist]
command = "npx"
args = ["-y", "todoist-mcp"]

[mcp_servers.todoist.env]
API_KEY = "your_todoist_api_token"

可用工具

任务

  • get_tasks_list：通过按项目、节、标签或ID进行可选筛选来获取任务
  • get_tasks_by_filter：使用Todoist过滤语言获取任务（例如。 "today", "overdue", "P1 | P2", "#Work & @urgent")
  • 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_comments_list：获取项目或任务的评论
  • create_comments：创建新评论
  • get_comments：按ID获取具体评论
  • update_comments：更新评论
  • delete_comments：删除评论

标签

  • 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格式获取项目列表及其部分和参数

示例用法

问你的人工智能助理（比如克劳德）一些问题，比如：

"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许可证获得许可-请参阅 许可证 文件以获取详细信息。

问题和支持

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

相关 MCP