Todoist MCP 服务器

这是一个模型上下文协议（MCP）服务器，允许像Claude这样的客户端与Todoist交互，通过自然语言实现任务管理功能。该服务器作为客户端和Todoist API之间的中介，处理认证、数据转换和命令处理。这是一个Python版本。

功能

• 创建任务：使用必需的内容和可选属性创建新任务
• 检索任务：通过ID获取任务或带有过滤选项的任务列表
• 任务管理：更新任务属性、标记任务为完成状态、删除任务

先决条件

• Python 3.12
• uv
• 一个Todoist账号及其API令牌

如何获取Todoist API令牌

1. 登录您的Todoist账户
2. 前往用户设置 -> 集成 -> 开发者
3. 复制API令牌

与Claude桌面版一起使用

通过UVX运行（无需克隆）

您可以直接从GitHub使用UVX运行服务器：

uvx --from https://github.com/Johnxjp/todoist-mcp-python.git mcp-server-todoist

然后将此配置添加到您的Claude设置中：

{
  "mcpServers": {
    "todoist-server": {
      "command": "uvx",
      "args": [
        "--from", 
        "https://github.com/Johnxjp/todoist-mcp-python.git", 
        "mcp-server-todoist"
      ],
      "env": {
        "TODOIST_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

从克隆的仓库运行

如果您更愿意克隆仓库，请使用以下命令：

git clone git@github.com:Johnxjp/todoist-mcp-python.git

然后将其添加到您的Claude配置文件中：

{
  "mcpServers": {
    "todoist-server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "todoist_api_python",
        "mcp",
        "run",
        "/full/path/to/todoist_server.py"
      ],
      "env": {
        "TODOIST_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

可用工具

服务器为Claude提供了以下工具：

1. create_task：在Todoist中创建新任务

   • 必需：content (任务标题)
   • 可选：
     • description,
     • due_date,
     • priority,
     • project_id,
     • section_id,
     • labels

2. get_tasks：使用多种过滤器从Todoist获取任务列表及ID

   • 可选：
     • project_id,
     • project_name,
     • task_name,
     • priority,
     • labels,
     • is_overdue,
     • limit

3. update_task：通过名称搜索现有任务并更新它

   • 必需：task_id
   • 可选：
     • content,
     • description,
     • labels,
     • priority,
     • due_date (YYYY-MM-DD),
     • deadline_date (YYYY-MM-DD)

4. delete_task：通过名称搜索任务并删除它

   • 必需：task_id

5. complete_task：通过名称搜索任务并标记为已完成

   • 必需：task_id

示例互动

这里有一些关于Claude如何通过这个MCP服务器与Todoist交互的例子：

• "添加一个购买杂货的任务"
• "显示我所有的紧急任务"
• "今天有哪些任务到期？"
• "将洗衣任务标记为已完成"
• "将我的牙医预约优先级改为紧急"

安全注意事项

• 服务器通过环境变量安全地处理您的Todoist API令牌
• 永远不要分享您的.env文件或暴露您的API令牌
• 服务器仅本地运行，并且只与Todoist API通信

许可证

MIT许可证

致谢

• Todoist API Python客户端
• 模型上下文协议