Google Tasks MCP Server

Google Tasks MCP 服务

用于管理 Google Tasks 的模型上下文协议（MCP）服务。

此 TypeScript MCP 服务通过集成 Google Tasks API，展示了 MCP 的核心概念。它可以结构化、高效地管理任务。

---

功能

资源

• 默认任务列表：通过 URI tasks://default 访问 Google Tasks 默认列表中的任务。
• 任务详情：提供任务的标题、备注和完成状态等元数据。
• JSON MIME 类型：任务以机器可读的 JSON 格式表示。

工具

• create_task：在默认任务列表中创建新任务。
  • 参数：
    • title（string，可选）：任务标题。
    • notes（string，可选）：任务的其他备注。
    • taskId（string，可选）：任务的唯一 ID。
    • status（string，可选）：任务状态（例如 "needsAction" 或 "completed"）。
  • 响应：返回已创建任务的详情。
• list_tasks：列出默认任务列表中的所有任务。
  • 参数：无。
  • 响应：返回默认任务列表中所有任务组成的 JSON 数组。
• delete_task：从默认任务列表中删除任务。
  • 参数：
    • taskId（string，必需）：要删除的任务 ID。
  • 响应：确认任务已成功删除。
• update_task：更新默认任务列表中已有的任务。
  • 参数：
    • taskId（string，必需）：要更新的任务 ID。
    • title（string，可选）：任务的新标题。
    • notes（string，可选）：任务的新备注。
  • 响应：返回更新后的任务详情。
• complete_task：切换任务的完成状态。
  • 参数：
    • taskId（string，必需）：要切换完成状态的任务 ID。
  • 响应：返回更新后的任务详情，包括新状态。

---

功能特性

• 通过 MCP 轻松集成大模型（LLM）或其他应用。
• 结构化的工具定义让任务管理直观且易于使用。
• 全面支持创建、列出、删除、更新任务，以及切换任务的完成状态。

---

用法

运行服务

启动服务：

node build/index.js

可用命令

• create_task： 使用可选参数创建新任务。

  {
    "title": "Complete project",
    "notes": "Finalize module 3",
    "status": "needsAction"
  }
  

• list_tasks： 获取默认任务列表中的所有任务。
  • 无需参数。
  • 返回任务数组。
• delete_task： 根据任务 ID 删除任务。

  {
    "taskId": "unique-task-id"
  }
  

• update_task： 根据任务 ID 更新任务标题、备注或其他详情。

  {
    "taskId": "unique-task-id",
    "title": "Updated task title",
    "notes": "Updated task notes"
  }
  

• complete_task： 切换任务的完成状态。

  {
    "taskId": "unique-task-id"
  }
  

complete_task 的响应示例

完成前

{
  "taskId": "unique-task-id",
  "title": "Finish the report",
  "status": "needsAction"
}

完成后

{
  "taskId": "unique-task-id",
  "title": "Finish the report",
  "status": "completed"
}

---

调试

由于 MCP 服务通过 stdio 通信，调试需要借助其他工具。我们推荐使用 MCP Inspector。

启动 Inspector：

npm run inspector

Inspector 会提供一个 URL，供你在浏览器中访问调试工具，从而更轻松地测试和调试服务。

许可证

此 MCP 服务采用 MIT 许可证授权。这意味着你可以自由使用、修改和分发此软件，但须遵守 MIT 许可证的条款和条件。