Google 任务 MCP 服务器

此模型上下文协议 (MCP) 服务器充当 Claude 和 Google Tasks 之间的桥梁，允许您直接通过 Claude 管理您的任务列表和任务。

注意: 此项目中所有代码（除了一些修改）都是由 Claude 根据我的指令 "vibe 编码" 生成的。

功能

此 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 Console
2. 创建新项目
3. 转到 "APIs & Services" > "Library"
4. 搜索 "Google Tasks API" 并启用它
5. 转到 "APIs & Services" > "Credentials"
6. 点击 "Create Credentials" > "OAuth Client ID"
7. 配置 OAuth 一致界面屏幕（对于个人使用，External 是可以的）
8. 对于应用程序类型，选择 "Web 应用程序"
9. 将 "http://localhost:3000" 添加为授权重定向 URI
10. 创建客户端 ID 和秘密

2. 配置 Claude for Desktop

1. 安装 Claude for Desktop
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. 构建并运行服务器

1. 安装依赖项：

npm install

2. 构建服务器：

npm run build

3. 重启 Claude for Desktop

认证流程

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

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

注意，您的认证是会话式的，并会在服务器重启时丢失。每次需要重新启动服务器时都需要重新认证。

要求

• Node.js 14+
• 最新版本的 Claude for Desktop
• 已启用 Google Cloud 项目中的 Tasks API

截图

许可证

此项目仅用于演示用途。自行承担风险使用。