gtasks-mcp - Google Tasks 模型上下文协议服务器

项目概述

gtasks-mcp 是一个专为 Claude AI 设计的 Google Tasks 模型上下文协议（MCP）服务器。该项目允许 Claude 直接与 Google Tasks API 集成，实现对 Google 任务的完整管理功能。

项目地址： https://github.com/zcaceres/gtasks-mcp

主要功能

核心工具（Tools）

1. search - 搜索任务

• 功能描述： 在 Google Tasks 中搜索任务
• 输入参数：
  • query (string): 搜索查询字符串
• 返回结果： 匹配的任务详细信息

2. list - 列出任务

• 功能描述： 列出 Google Tasks 中的所有任务
• 输入参数：
  • cursor (string, 可选): 分页游标
• 返回结果： 所有任务的列表

3. create - 创建任务

• 功能描述： 在 Google Tasks 中创建新任务
• 输入参数：
  • taskListId (string, 可选): 任务列表ID
  • title (string, 必需): 任务标题
  • notes (string, 可选): 任务备注
  • due (string, 可选): 截止日期
• 返回结果： 任务创建确认信息

4. update - 更新任务

• 功能描述： 更新现有的 Google Tasks 任务
• 输入参数：
  • taskListId (string, 可选): 任务列表ID
  • id (string, 必需): 任务ID
  • uri (string, 必需): 任务URI
  • title (string, 可选): 新任务标题
  • notes (string, 可选): 新任务备注
  • status (string, 可选): 新任务状态（"needsAction" 或 "completed"）
  • due (string, 可选): 新截止日期
• 返回结果： 任务更新确认信息

5. delete - 删除任务

• 功能描述： 删除 Google Tasks 中的任务
• 输入参数：
  • taskListId (string, 必需): 任务列表ID
  • id (string, 必需): 任务ID
• 返回结果： 任务删除确认信息

6. clear - 清除已完成任务

• 功能描述： 清除 Google Tasks 任务列表中的已完成任务
• 输入参数：
  • taskListId (string, 必需): 任务列表ID
• 返回结果： 清除操作确认信息

资源（Resources）

服务器提供对 Google Tasks 资源的访问：

• 任务资源 (gtasks:///<task_id>)
  • 表示 Google Tasks 中的单个任务
  • 支持读取任务详细信息，包括标题、状态、截止日期、备注和其他元数据
  • 可以使用提供的工具进行列出、读取、创建、更新和删除操作

安装和配置

前置要求

1. 创建 Google Cloud 项目

   • 访问 Google Cloud Console 创建新项目

2. 启用 Google Tasks API

   • 在 Google Cloud Console 中启用 API

3. 配置 OAuth 同意屏幕

   • 在 OAuth 同意屏幕 进行配置
   • 测试环境选择 "internal" 即可
   • 添加作用域：https://www.googleapis.com/auth/tasks

4. 创建 OAuth 客户端 ID

   • 在 凭据页面 创建
   • 应用程序类型选择 "桌面应用"
   • 下载 OAuth 密钥的 JSON 文件
   • 将密钥文件重命名为 gcp-oauth.keys.json 并放置在项目根目录

构建项目

使用以下命令构建服务器：

npm run build

或使用监听模式：

npm run watch

自动安装（推荐）

通过 Smithery 自动安装：

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

身份验证

1. 运行服务器并进行身份验证：

npm run start auth

2. 这将在系统浏览器中打开身份验证流程
3. 完成身份验证过程
4. 凭据将保存在项目根目录（.gdrive-server-credentials.json）

Claude Desktop 集成

要将此服务器与 Claude Desktop 应用程序集成，请在应用程序的服务器配置中添加以下内容：

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

技术特点

• 完整的 CRUD 操作：支持任务的创建、读取、更新、删除
• 高级搜索功能：可以根据关键词搜索任务
• 任务状态管理：支持标记任务为完成或待处理
• 分页支持：处理大量任务时提供分页功能
• OAuth 2.0 认证：安全的 Google API 访问
• TypeScript 支持：提供类型安全和更好的开发体验

使用场景

• 个人任务管理：通过 Claude 自然语言交互管理日常待办事项
• 项目协作：在团队项目中通过 AI 助手管理任务分配
• 自动化工作流：结合其他工具实现任务管理自动化
• 生产力提升：通过语音或文本快速创建和更新任务

注意事项

• 需要有效的 Google 账户和 Google Tasks 访问权限
• 首次使用需要完成 OAuth 认证流程
• 建议在生产环境中妥善保管认证凭据文件
• 遵循 Google API 使用配额和限制