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 中的单个任务
- 支持读取任务详细信息，包括标题、状态、截止日期、备注和其他元数据
- 可以使用提供的工具进行列出、读取、创建、更新和删除操作

安装和配置

前置要求

创建 Google Cloud 项目
- 访问 Google Cloud Console 创建新项目
启用 Google Tasks API
- 在 Google Cloud Console 中启用 API
配置 OAuth 同意屏幕
- 在 OAuth 同意屏幕进行配置
- 测试环境选择 "internal" 即可
- 添加作用域：https://www.googleapis.com/auth/tasks
创建 OAuth 客户端 ID
- 在凭据页面创建
- 应用程序类型选择 "桌面应用"
- 下载 OAuth 密钥的 JSON 文件
- 将密钥文件重命名为 gcp-oauth.keys.json 并放置在项目根目录

构建项目

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

npm run build

或使用监听模式：

npm run watch

自动安装（推荐）

通过 Smithery 自动安装：

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

身份验证

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

npm run start auth

这将在系统浏览器中打开身份验证流程
完成身份验证过程
凭据将保存在项目根目录（.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 使用配额和限制