Google Tasks MCP 服务器

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

注意： 此项目中的所有代码（除了一些编辑）都是 "vibe coded" - 由 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 Console
2. 创建一个新项目
3. 导航到“API 和服务”>“库”
4. 搜索“Google Tasks API”并启用它
5. 转到“API 和服务”>“凭据”
6. 单击“创建凭据”>“OAuth 客户端 ID”
7. 配置 OAuth 同意屏幕（个人使用外部即可）
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（最新版本）
• 启用了 Tasks API 的 Google Cloud 项目

截图

许可证

本项目仅用于演示目的。 使用风险自负。