Google Tasks MCP Server

Google Tasks MCP 服务

此 MCP 服务集成 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 Client ID
6. 下载客户端 OAuth 密钥的 JSON 文件
7. 将密钥文件重命名为 gcp-oauth.keys.json，并放在此仓库的根目录中（即 gcp-oauth.keys.json）

请确保使用 npm run build 或 npm run watch 构建服务。

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Google Tasks Server：

npx -y @smithery/cli install @zcaceres/gtasks --client claude

身份验证

要进行身份验证并保存凭据：

1. 使用 auth 参数运行服务：npm run start auth
2. 这将在系统浏览器中打开身份验证流程
3. 完成身份验证过程
4. 凭据将保存在此仓库的根目录中（即 .gdrive-server-credentials.json）

与桌面应用搭配使用

要将此服务集成到桌面应用中，请在应用的服务配置中添加以下内容：

{
  "mcpServers": {
    "gtasks": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}