Google Tasks MCP 服务器

此模型上下文协议（MCP）服务器在 Claude 和 Google Tasks 之间架设桥梁，让您可以直接通过 Claude 管理您的任务列表和任务。

注意： 本项目中所有（除少量修改外）代码均为"vibe 编码"生成——由 Claude 根据我的指令生成。

功能

此 MCP 服务器提供以下功能：

任务列表管理

• list-tasklists - 列出所有您的任务列表
• get-tasklist - 获取特定任务列表的详细信息
• create-tasklist - 创建新的任务列表
• update-tasklist - 更新现有任务列表
• delete-tasklist - 删除任务列表

任务管理

• list-tasks - 列出任务列表中的所有任务
• get-task - 获取特定任务的详细信息
• create-task - 创建新任务
• update-task - 更新现有任务
• delete-task - 删除任务
• complete-task - 将任务标记为已完成
• move-task - 移动任务（重新排序或更改父级）
• clear-completed-tasks - 清除列表中所有已完成的任务

安装说明

1. 创建 Google Cloud 项目并启用 API

1. 前往 Google Cloud 控制台
2. 创建新项目
3. 导航至 "APIs & Services" > "Library"
4. 搜索 "Google Tasks API" 并启用它
5. 前往 "APIs & Services" > "Credentials"
6. 点击 "Create Credentials" > "OAuth Client ID"
7. 配置 OAuth 同意屏幕（个人使用选择外部即可）
8. 在应用类型中，选择 "Web application"
9. 将 "http://localhost:3000" 添加为授权重定向 URI
10. 创建客户端 ID 和密钥

2. 配置桌面版 Claude

1. 安装 桌面版 Claude
2. 打开 Claude 配置文件：
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. 添加 Google Tasks MCP 服务器配置：

{
  "mcpServers": {
    "google-tasks": {
      "command": "node",
      "args": ["/path/to/google-tasks-mcp/build/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id_here",
        "GOOGLE_CLIENT_SECRET": "your_client_secret_here",
        "GOOGLE_REDIRECT_URI": "http://localhost:3000/oauth2callback"
      }
    }
  }
}

将路径和凭证替换为您自己的值。

3. 构建并运行服务器

通过 Smithery 安装

要自动通过 Smithery 为 Claude Desktop 安装 Google Tasks 集成服务器：

npx -y @smithery/cli install @arpitbatra123/mcp-googletasks --client claude

手动安装

1. 安装依赖：

npm install

2. 构建服务器：

npm run build

3. 重启桌面版 Claude

认证流程

首次使用 Google Tasks MCP 服务器时：

1. 使用 authenticate 工具获取授权 URL
2. 在浏览器中访问该 URL 并使用您的 Google 账户登录
3. 授权后，您将在浏览器页面收到一个代码
4. 使用 set-auth-code 工具并输入此代码完成认证
5. 现在您可以使用所有其他工具与 Google Tasks 交互

请注意，您的认证基于会话，重启服务器时会丢失。您需要每次重新认证。

要求

• Node.js 14+
• 桌面版 Claude（最新版本）
• 已启用 Tasks API 的 Google Cloud 项目

截图

许可证

本项目仅用于演示目的。自行承担使用风险。