mcp-googletasks

🚀 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

截图

📄 许可证

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