Google Workspace API服务器

谷歌工作区MCP服务器

用于谷歌工作区API的MCP服务器-文档、表格、驱动器、Gmail和日历。将其与Claude Code一起使用，可以阅读、创建和编辑谷歌文档和表格，管理评论，阅读电子邮件和查看日历事件。

快速开始

1. 获取您的Google凭据（请参阅 设置 在......下面
2. 添加到您的Claude代码配置中(~/.claude.json):

{
  "mcpServers": {
    "google-workspace": {
      "type": "stdio",
      "command": "npx",
      "args": ["google-workspace-mcp-server"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

3. 重新启动Claude代码

设置

第一步：创建谷歌云项目

1. 首选 谷歌云控制台
2. 单击项目下拉列表（左上角）→ 新项目
3. 将其命名为“MCP服务器”→ 创建
4. 等待项目创建，然后选择它

步骤2：启用API

1. 首选 API和服务 → 图书馆 （或 点击此处)
2. 搜索并启用以下每个API：
   • 谷歌文档API → 点击→ 启用
   • 谷歌网页API → 点击→ 启用
   • Google Drive API → 点击→ 启用
   • Gmail API → 点击→ 启用
   • 谷歌日历API → 点击→ 启用

步骤3：配置OAuth同意屏幕

1. 首选 API和服务 → OAuth 同意屏幕
2. 选择用户类型：
   • 内部 （仅当您有谷歌工作区时）-更简单，无需测试用户设置
   • 外部的 （适用于个人Gmail帐户）-需要将自己添加为测试用户
3. 点击 创建
4. 填写必填字段：
   • 应用程序名称：“MCP服务器”（或任何东西）
   • 用户支持电子邮件：您的电子邮件
   • 开发人员联系电子邮件：您的电子邮件
5. 点击 保存并继续
6. 开 范围 页面，单击 保存并继续 （无需更改）
7. 开 测试用户 页面（仅限外部）：单击 添加用户 → 添加您的谷歌电子邮件→ 保存并继续
8. 点击 返回仪表盘

步骤4：创建OAuth凭据

1. 首选 API和服务 → 凭证
2. 点击 创建凭据 → OAuth客户端ID
3. 应用程序类型： Web应用程序
4. 名称：“MCP服务器”（或任何东西）
5. 在...之下 授权重定向URI，单击 添加URI 并输入：
   复制

   https://developers.google.com/oauthplayground
   

6. 点击 创建
7. 复制并保存您的客户端ID和客户端密码 -你需要这些！

步骤5：获取刷新令牌

1. 首选 OAuth 2.0游乐场

2. 点击 齿轮图标 (⚙️) 右上角

3. 检查 “使用您自己的OAuth凭据”

4. 输入你的 客户端ID 和 客户端密钥 从步骤4开始

5. 关闭设置

6. 在左侧面板中，找到并选择这些范围：

   • Google文档API v1 → https://www.googleapis.com/auth/documents
   • Google Sheets API v4 → https://www.googleapis.com/auth/spreadsheets
   • Google Drive API v3 → https://www.googleapis.com/auth/drive
   • Gmail API v1 → https://www.googleapis.com/auth/gmail.readonly
   • Gmail API v1 → https://www.googleapis.com/auth/gmail.compose （用于创建草稿）
   • 谷歌日历API v3 → https://www.googleapis.com/auth/calendar.readonly

7. 点击 授权API

8. 使用您的Google帐户登录并授予权限

   • 如果您看到“谷歌尚未验证此应用程序”，请单击 高级 → 转到MCP服务器（不安全）
   • 点击 继续 授予权限

9. 点击 兑换授权码以获取令牌

10. 复制刷新令牌 （不是访问令牌！）-这就是你需要的！

步骤6：配置Claude代码

将MCP服务器添加到您的Claude Code设置中。编辑 ~/.claude.json:

{
  "mcpServers": {
    "google-workspace": {
      "type": "stdio",
      "command": "npx",
      "args": ["google-workspace-mcp-server"],
      "env": {
        "GOOGLE_CLIENT_ID": "123456789-abcdefg.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "GOCSPX-xxxxxxxxxxxxx",
        "GOOGLE_REFRESH_TOKEN": "1//04xxxxxxxxxxxxx"
      }
    }
  }
}

用步骤4和5中的实际凭据替换这些值。

步骤7：重新启动Claude代码

重新启动Claude Code以加载新的MCP服务器。您现在应该可以使用Google Workspace工具了！

工具

谷歌文档API

谷歌网页API

Google Drive API

Gmail API

Google日历API（只读）

使用示例

配置后，您可以向Claude Code询问以下内容：

• “阅读我的谷歌文档https://docs.google.com/document/d/abc123/edit"
• “从我的驱动器阅读此PDF：https://drive.google.com/file/d/xyz789/view"
• “从今天开始，使用会议笔记创建一个新的谷歌文档”
• “在我的电子表格中添加一行今天的数据”
• “在我的驱动器中搜索有关项目规划的文件”
• “显示对此文档的评论”
• “回复约翰的评论，说我明天会修好它”
• “显示我的未读电子邮件”
• “查找来自的电子邮件notifications@github.com"
• “今天我的日历上有什么？”
• “显示我本周的会议”
• “获取那次站立会议的详细信息”

故障排除

“访问令牌过期”错误

MCP服务器会使用您的刷新令牌自动刷新令牌。如果您看到此错误，则您的刷新令牌可能已被吊销。再次执行步骤5以获取新的。

“应用程序未验证”警告

这对个人项目来说很正常。点击 高级 → 转到[应用程序名称]（不安全） 继续。

“权限不足”错误

确保在步骤2中启用了所有五个API（文档、表格、驱动器、Gmail、日历），并在步骤5中选择了所有五种作用域。

环境变量

发展

# Clone the repo
git clone https://github.com/nityeshaga/google-workspace-mcp-server.git
cd google-workspace-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start

许可证

麻省理工学院