SuperAPI AI 工具集

gtasks-mcp

gtasks-mcp 是一个 Google Tasks 的 Model Context Protocol(MCP)服务器,用于与 Claude 等支持 MCP 的客户端集成,实现对 Google Tasks 中任务的搜索、列表、创建、更新和删除等操作。该服务器提供搜索、列出全部任务、创建任务、更新任务、删除任务以及清空已完成任务等工具,并支持通过资源地址读取单个任务详情。使用前需要创建 Google Cloud 项目、启用 Google Tasks API、配置 OAuth 同意屏幕并添加 https://www.googleapis.com/auth/tasks 范围,创建桌面应用类型的 OAuth 客户端 ID,将下载的密钥文件重命名为 gcp-oauth.keys.json 并放置于仓库根目录,然后构建服务器。可通过 Smithery 自动安装到 Claude Desktop,也可手动在桌面应用的服务器配置中添加。认证流程通过运行 npm run start auth 在系统浏览器中完成,凭据将保存至仓库根目录的 .gdrive-server-credentials.json 文件中。

访问官网

工具介绍

用途

gtasks-mcp 是一个 Google Tasks 的 Model Context Protocol(MCP)服务器,用于将 Google Tasks 集成到支持 MCP 的客户端(如 Claude),使客户端能够通过工具调用管理 Google Tasks 中的任务。

主要能力

该服务器提供以下工具:

  • search:在 Google Tasks 中搜索任务。输入 query(字符串,搜索查询),返回匹配的任务及详细信息。
  • list:列出 Google Tasks 中的所有任务。可选输入 cursor(字符串,用于分页),返回全部任务列表。
  • create:在 Google Tasks 中创建新任务。输入 taskListId(字符串,可选,任务列表 ID)、title(字符串,必填,任务标题)、notes(字符串,可选,任务备注)、due(字符串,可选,截止日期),返回任务创建确认。
  • update:更新 Google Tasks 中的现有任务。输入 taskListId(字符串,可选,任务列表 ID)、id(字符串,必填,任务 ID)、uri(字符串,必填,任务 URI)、title(字符串,可选,新任务标题)、notes(字符串,可选,新任务备注)、status(字符串,可选,新任务状态,取值为 "needsAction" 或 "completed")、due(字符串,可选,新截止日期),返回任务更新确认。
  • delete:删除 Google Tasks 中的任务。输入 taskListId(字符串,必填,任务列表 ID)、id(字符串,必填,任务 ID),返回任务删除确认。
  • clear:清空 Google Tasks 任务列表中已完成的任务。输入 taskListId(字符串,必填,任务列表 ID),返回清空任务的确认。

此外,服务器提供对 Google Tasks 资源的访问:Tasks(gtasks:///<task_id>)代表 Google Tasks 中的单个任务,支持读取任务详情,包括标题、状态、截止日期、备注及其他元数据,并可通过上述工具进行列出、读取、创建、更新和删除。

使用方式

准备工作

  1. 创建新的 Google Cloud 项目。
  2. 启用 Google Tasks API。
  3. 配置 OAuth 同意屏幕(测试可使用 "internal")。
  4. 添加范围 https://www.googleapis.com/auth/tasks。
  5. 创建应用类型为 "Desktop App" 的 OAuth 客户端 ID。
  6. 下载客户端 OAuth 密钥的 JSON 文件。
  7. 将密钥文件重命名为 gcp-oauth.keys.json 并放置到本仓库根目录(即 gcp-oauth.keys.json)。
  8. 使用 npm run build 或 npm run watch 构建服务器。

通过 Smithery 安装

可通过 Smithery 自动安装 Google Tasks Server 到 Claude Desktop。

认证与保存凭据

运行带 auth 参数的服务器:npm run start auth。这将在系统浏览器中打开认证流程,完成认证后凭据将保存在本仓库根目录(即 .gdrive-server-credentials.json)。

与桌面应用配合使用

要将此服务器与桌面应用集成,请在应用的服务器配置中添加相应配置。

适用场景

适用于需要让支持 MCP 的客户端(如 Claude)帮助管理 Google Tasks 的任务搜索、列表查看、创建、更新、删除及清空已完成任务的场景。

限制

资料未提供关于平台兼容性、收费、价格、性能或效果的具体信息,这些方面暂未提供。