Google Tasks MCP 服务器

用于在 Claude Desktop 中集成 Google Tasks 的模型上下文协议 (MCP) 服务器。此服务器使AI助手能够通过自然语言交互管理 Google Tasks。

从 Zach Caceres (zcaceres) 的原始实现 gtasks-mcp 分支出来，以增强身份验证处理，添加对多个任务列表的支持，并提供一个更强大的 npm 包，与 Smithery 集成以供 Claude Desktop 使用。这个分支已完全功能化并正确部署在 Smithery 上，使其可以立即与 Claude 一起使用。

功能

• 列出您 Google Tasks 列表中的所有任务
• 通过查询搜索特定任务
• 创建带有标题、备注和截止日期的新任务
• 更新现有任务（标题、备注、状态、截止日期）
• 删除任务
• 清除任务列表中的已完成任务
• 完整集成 Google Tasks API
• 安全的 OAuth2 身份验证
• 支持 Docker 容器化部署

任务创建示例

这是一个使用自然语言与 Claude 创建任务的简单示例：

只需简单的指令如“创建一个名为‘早上吃香蕉’的任务”，Claude 就能立即在您的 Google Tasks 中创建该任务。

安装

通过 Smithery 安装

要自动安装 Google Tasks 集成到 Claude Desktop：

npx -y @smithery/cli install @alvincrave/gtasks-mcp --client claude

手动安装

npm install @alvincrave/gtasks-mcp

设置

1. 创建一个 Google Cloud 项目并获取凭证：

   a. 创建一个 Google Cloud 项目：

   • 访问 Google Cloud 控制台
   • 创建一个新的项目或选择一个现有的项目
   • 为您的项目启用 Google Tasks API

   b. 创建 OAuth 2.0 凭证：

   • 前往“APIs & Services” > “Credentials”
   • 点击“Create Credentials” > “OAuth client ID”
   • 选择“Desktop app”作为应用类型
   • 给它命名并点击“Create”
   • 您将获得 GOOGLE_CLIENT_ID 和 GOOGLE_CLIENT_SECRET

   c. 获取刷新令牌：

   • 访问 OAuth 2.0 Playground
   • 点击右上角的齿轮图标（设置）
   • 勾选“Use your own OAuth credentials”
   • 输入您的 OAuth 客户端ID和客户端密钥
   • 在左侧面板中找到“Tasks API v1”并选择“https://www.googleapis.com/auth/tasks”
   • 点击“Authorize APIs”并完成 OAuth 流程
   • 点击“Exchange authorization code for tokens”
   • 复制“刷新令牌”——这就是您的 GOOGLE_REFRESH_TOKEN

2. 在 Claude Desktop 中配置：

{
  "mcpServers": {
    "gtasks": {
      "command": "npx",
      "args": ["-y", "@alvincrave/gtasks-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id_here",
        "GOOGLE_CLIENT_SECRET": "your_client_secret_here",
        "GOOGLE_REFRESH_TOKEN": "your_refresh_token_here"
      },
      "connectionTypes": ["stdio"],
      "autoRestart": true
    }
  }
}

Docker 支持

您可以在 Docker 容器中运行此服务器：

# 构建 Docker 镜像
docker build -t gtasks-mcp .

# 运行容器
docker run -p 3000:3000 \
  -e GOOGLE_CLIENT_ID=your_client_id \
  -e GOOGLE_CLIENT_SECRET=your_client_secret \
  -e GOOGLE_REFRESH_TOKEN=your_refresh_token \
  gtasks-mcp

使用示例

服务器提供了几个可以通过 Claude Desktop 使用的工具：

搜索任务

搜索包含“会议”的任务

列出任务

显示我所有的任务

创建任务

创建一个任务“准备演示文稿”，截止日期为周五

更新任务

标记“发送电子邮件”任务为已完成

删除任务

删除关于“旧项目”的任务

清除已完成任务

清除我的列表中的所有已完成任务

安全注意事项

• 保护好您的 Google API 凭证
• 定期轮换您的刷新令牌
• 在 Claude Desktop 配置中存储敏感信息
• 不要分享或提交您的凭证到版本控制系统
• 刷新令牌可访问您的 Google Tasks，请像对待密码一样对待它

许可证

本项目采用 MIT 许可证。