任务管理服务

Todoist MCP Server是一个任务管理服务,提供任务、项目和标签的创建、更新、删除等功能,支持自然语言日期和过滤器语法。

  • by arcforgelabs-archive
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 IAMSamuelRodda/todoist-mcp

使用说明

Todoist MCP服务器

用于Todoist任务管理的MCP服务器。为任务、项目和标签提供12个工具。

特性

  • 任务:创建、列出、更新、完成、重新打开和删除任务
  • 项目:列出并创建项目,包括子项目
  • 标签:列出任务组织并创建标签
  • 过滤器:支持Todoist过滤器语法(today, overdue, p1等等)
  • 自然语言日期:使用 tomorrow, next Monday, every week等等。

安装

选项1:uvx(推荐)

零安装方法使用 紫外线.添加到 ~/.claude.json:

{
  "mcpServers": {
    "todoist": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/IAMSamuelRodda/todoist-mcp", "todoist-mcp"],
      "env": {
        "TODOIST_API_TOKEN": "your-api-token"
      }
    }
  }
}

选项2:本地克隆

mkdir -p ~/.claude/mcp-servers
git clone https://github.com/IAMSamuelRodda/todoist-mcp.git ~/.claude/mcp-servers/todoist-mcp
cd ~/.claude/mcp-servers/todoist-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

添加到 ~/.claude.json:

{
  "mcpServers": {
    "todoist": {
      "command": "~/.claude/mcp-servers/todoist-mcp/.venv/bin/python",
      "args": ["~/.claude/mcp-servers/todoist-mcp/todoist_mcp.py"],
      "env": {
        "TODOIST_API_TOKEN": "your-api-token"
      }
    }
  }
}

获取您的API代币

  1. 打开Todoist(网络或应用程序)
  2. 首选 设置 → 集成 → 开发者
  3. 复制您的 API令牌

更新中

uvx用户

uv cache clean todoist-mcp

本地克隆用户

cd ~/.claude/mcp-servers/todoist-mcp
git pull
source .venv/bin/activate
pip install -r requirements.txt

可用工具

工具 说明
todoist_list_projects 列出所有项目
todoist_get_project 获取项目详细信息
todoist_create_project 创建新项目
todoist_list_tasks 使用筛选器列出任务
todoist_get_task 获取任务详细信息
todoist_create_task 创建新任务
todoist_update_task 更新任务
todoist_complete_task 标记任务完成
todoist_reopen_task 重新打开已完成的任务
todoist_delete_task 删除任务
todoist_list_labels 列出所有标签
todoist_create_label 创建新标签

使用示例

配置后,您可以询问Claude:

  • “显示我今天的任务”
  • “创建一个任务来审查下周五到期的季度报告”
  • “列出我的所有项目”
  • “将任务123456789标记为已完成”
  • “我的逾期任务是什么?”
  • “在我的工作项目中创建高优先级任务”

筛选器语法

这 todoist_list_tasks 该工具支持Todoist的过滤语法:

  • today -今天到期的任务
  • tomorrow -明天到期的任务
  • overdue -逾期任务
  • p1, p2, p3, p4 -按优先级筛选
  • no due date -没有截止日期的任务
  • 7 days -未来7天内到期的任务
  • @label_name -带有特定标签的任务
  • #project_name -特定项目中的任务

许可证

麻省理工学院