mcp-google-tasks

🚀 谷歌任务 MCP 服务器

本项目是一个基于 TypeScript 的 MCP 服务器，主要用于管理谷歌任务。它通过集成谷歌任务 API，以结构化且高效的方式实现了与任务的交互式管理，为用户提供了便捷的任务管理功能。

🚀 快速开始

要启动服务器，可执行以下命令：

node build/index.js

✨ 主要特性

资源

• 默认任务列表：可通过 URI tasks://default 访问默认的谷歌任务列表。
• 任务详情：能提供有关任务的元数据，如标题、笔记和完成状态。
• JSON MIME 类型：任务以机器可读的 JSON 格式表示。

工具

• create_task：用于在默认任务列表中创建新任务。

  • 参数：
    • title（字符串，可选）：任务标题。
    • notes（字符串，可选）：任务的附加笔记。
    • taskId（字符串，可选）：任务的唯一 ID。
    • status（字符串，可选）：任务状态（例如“needsAction”或“completed”）。
  • 响应：返回创建的任务的详细信息。

• list_tasks：列出默认任务列表中的所有任务。

  • 参数：无。
  • 响应：返回默认任务列表中所有任务的 JSON 数组。

• delete_task：从默认任务列表中删除任务。

  • 参数：
    • taskId（字符串，必需）：要删除的任务 ID。
  • 响应：确认成功删除任务。

• update_task：更新现有任务的详细信息。

  • 参数：
    • taskId（字符串，必需）：要更新的任务 ID。
    • title（字符串，可选）：新任务标题。
    • notes（字符串，可选）：新任务笔记。
  • 响应：返回已更新的任务详细信息。

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

  • 参数：
    • taskId（字符串，必需）：要切换完成状态的任务 ID。
  • 响应：返回已更新的任务详细信息，包括新的状态。

💻 使用示例

基础用法

create_task

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

{
    "title": "完成项目",
    "notes": "完成模块 3",
    "status": "needsAction"
}

list_tasks

检索默认任务列表中的所有任务，无参数要求，返回任务数组。

delete_task

根据任务 ID 删除任务：

{
    "taskId": "唯一任务 ID"
}

update_task

更新现有任务的标题、笔记或其他详细信息：

{
    "taskId": "唯一任务 ID",
    "title": "新标题",
    "notes": "新笔记"
}

complete_task

切换任务的完成状态：

{
    "taskId": "唯一任务 ID"
}

📚 详细文档

• 提供与大型语言模型（LLMs）或其他应用程序轻松集成的功能。
• 结构化的工具定义使任务管理直观且易于访问。
• 完整支持创建、列出、删除、更新和切换任务完成状态等功能。

🔧 技术细节

在调试时，您可以使用 MCP 检查工具来分析和解决问题。有关更多信息，请访问 MCP Inspector。

📄 许可证

该软件遵循 MIT 许可证。请参阅 LICENSE 文件以获取详细信息。