Google MCP

OpenBSP MCP for Google Workspace

一个公开的 Model Context Protocol（MCP）服务，让 AI 助手能够访问你的 Google Calendar 和 Sheets。

在线地址：https://g.mcp.openbsp.dev

为什么要创建这个项目

大多数 Google MCP 服务都要求你创建自己的 Google Cloud 项目、设置 OAuth 凭据，并运行本地服务。这既繁琐又容易出错。

**这个项目与众不同。**它是一个提供代理 OAuth 的托管公共服务。你只需：

1. 点击“使用 Google 登录”
2. 获取 API 密钥
3. 将其添加到你的 MCP 客户端

无需设置 Google Cloud，无需运行本地服务，也无需环境变量。连接即可使用。

你可以做什么

连接后，可以让 AI 助手：

• 列出并搜索你的日历事件
• 创建、更新或删除事件
• 读取和写入 Google Sheets
• 创建新的电子表格

工作原理

┌──────────────┐     ┌──────────────────┐     ┌──────────────┐
│  AI Client   │────▶│  OpenBSP MCP     │────▶│  Google APIs │
│  (Claude)    │◀────│  Server          │◀────│              │
└──────────────┘     └──────────────────┘     └──────────────┘

1. 选择要连接的 Google 产品（Calendar、Sheets）
2. 使用 Google 进行身份验证并授予权限
3. 获取 API 密钥，用于配置 MCP 客户端
4. AI 助手现在即可访问你的 Google 数据

隐私与安全

我们存储的内容

数据	用途	保护方式
API 密钥	对 MCP 客户端进行身份验证	原样存储（随机 256 位值）
OAuth 令牌	代表你访问 Google API	使用 AES-256-GCM 加密
Scopes	记住你授权的产品	不加密

OAuth 令牌在静态存储时使用 AES-256-GCM 加密。加密密钥与数据库分开存储，因此仅发生数据库泄露不会导致你的 Google 令牌暴露。

我们不会存储的内容

• 你的 Google 密码
• 你的邮件内容
• 你的日历事件或电子表格数据
• 任何个人信息

数据保留期限

• API 密钥：保留至你撤销密钥（或设置了到期时间时，保留至到期）
• OAuth 令牌：与 API 密钥一同存储
• 临时身份验证状态：10 分钟后删除

如何撤销访问权限

选项 1：删除 API 密钥

curl -X DELETE https://g.mcp.openbsp.dev/key/YOUR_API_KEY

选项 2：在 Google 中撤销

1. 前往 Google 账号安全
2. 在列表中找到“OpenBSP MCP”
3. 点击“移除访问权限”

这两种方式都会立即使你的 API 密钥失效。

MCP 客户端设置

完成身份验证后，将以下内容添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "google-mcp": {
      "url": "https://g.mcp.openbsp.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

程序化集成

MCP 客户端可以通过将用户重定向到以下地址来自动完成设置：

https://g.mcp.openbsp.dev/auth/google?products=calendar,sheets&callback=YOUR_CALLBACK_URL

身份验证完成后，用户会被重定向到你的回调地址，凭据包含在 URL 片段中：

YOUR_CALLBACK_URL#api_key=gmc_xxx&url=https://g.mcp.openbsp.dev/mcp&[email protected]&files=Budget.xlsx,Sales.xlsx

参数	说明
api_key	生成的 API 密钥
url	MCP 端点 URL
email	授权访问的 Google 账号邮箱
files	以逗号分隔的文件名（仅在已授权 Sheets 且已选择文件时提供）

可用工具

Calendar

请求的权限范围：

• calendar.events - 读取和写入事件
• calendar.calendarlist.readonly - 列出你的日历（只读）

工具	说明
list_calendars	列出你的所有日历
list_events	获取事件，可选择按日期筛选
check_availability	检查忙闲时间（不会暴露事件详情）
create_event	创建新的日历事件
update_event	更新现有事件
delete_event	删除事件

Sheets

请求的范围：

• drive.file - 仅访问您选择的文件或应用创建的文件

工具	描述
list_authorized_files	列出用户已授权访问的文件
get_spreadsheet	获取电子表格元数据、工作表和表格
get_sheet_schema	获取列名和推断出的类型
describe_sheet	获取所有列的统计摘要
search_rows	搜索符合筛选条件的行
semantic_search	由 AI 驱动的行语义搜索（按含义查找，而非精确匹配）
read_sheet	读取某个范围内的数据（例如，“A1:D10”）
write_sheet	将数据写入某个范围
append_rows	追加行（支持使用 tableId 对表格进行感知页脚的追加）
create_spreadsheet	创建新的电子表格

drive.file 范围仅允许访问用户在身份验证期间通过 Google Drive Picker 明确选择的文件，或由应用创建的文件。使用 list_authorized_files 查找可用的电子表格。

表格支持： get_spreadsheet 工具会返回表格元数据，包括 tableId。将其传递给 append_rows，即可正确地以表格感知方式追加内容，并保留页脚且自动扩展表格。

语义搜索： semantic_search 工具使用 AI 嵌入向量按含义查找行。由 TAG 提供支持。

自托管

想要运行自己的实例？请参阅 DEPLOY.md 获取说明。

常见问题

这是官方项目吗？ 不是，这是一个独立的开源项目，与 Google 或 Anthropic 无关。

它安全吗？ 我们只请求所需的最低权限。您的数据会通过我们的服务在 Google 和您的 AI 客户端之间直接传输——我们不会存储或记录这些数据。

我可以查看代码吗？ 可以！此项目为开源项目。您可以查看代码、运行自己的实例，或贡献改进。

如果我丢失了 API 密钥怎么办？ 重新进行身份验证即可生成新的密钥。除非您撤销旧密钥，否则它们仍然有效。

需要付费吗？ 此公共实例免费。如果您选择自托管，则需要支付 Cloudflare Workers 的费用（提供额度充足的免费套餐）。