Google Sheets Mcp

Google Sheets MCP

一个 Model Context Protocol (MCP) 服务，可通过 OAuth 为 Claude（及其他 MCP 客户端）提供对任意 Google 表格的读写权限。

工具

工具	描述
read_sheet	读取电子表格中任意范围的数据
write_sheet	写入或更新电子表格中的数据
append_rows	向电子表格追加新行
get_sheet_info	获取工作表名称、行数和列数
clear_range	清除单元格范围

所有工具都接受完整的 Google Sheets URL 或 单独的电子表格 ID。

---

前置条件

• Node.js 18+
• Google 账号
• Google Cloud 项目（免费）

---

设置

1. 克隆仓库

git clone https://github.com/generalist-club/google-sheets-mcp.git
cd google-sheets-mcp
npm install

2. 创建 Google Cloud 项目和 OAuth 凭据

1. 前往 Google Cloud Console
2. 创建新项目（或选择现有项目）
3. 启用 Google Sheets API 和 Google Drive API：
   • 前往 APIs & Services → Library
   • 搜索并启用这两个 API
4. 创建 OAuth 凭据：
   • 前往 APIs & Services → Credentials
   • 点击 Create Credentials → OAuth client ID
   • 应用类型：Desktop app
   • 下载 JSON 文件
5. 将下载的文件重命名为 credentials.json，并放到项目根目录

3. 进行身份验证

运行身份验证脚本以生成令牌：

node auth.js

脚本会输出一个 URL。在浏览器中打开该 URL，授权应用，然后将代码粘贴回终端。这会在本地创建一个 token.json 文件，请妥善保密。

令牌刷新： 令牌过期时，服务会自动刷新访问令牌。通常只需运行一次 auth.js。

4. 配置 Claude Desktop（或任何 MCP 客户端）

将此服务添加到 ~/Library/Application Support/Claude/claude_desktop_config.json 中的 Claude Desktop 配置：

{
  "mcpServers": {
    "google-sheets": {
      "command": "node",
      "args": ["/absolute/path/to/google-sheets-mcp/index.js"]
    }
  }
}

将 /absolute/path/to/google-sheets-mcp 替换为你计算机上的实际路径。

重启 Claude Desktop。现在即可使用这五个 Google Sheets 工具。

---

使用示例

连接后，你可以向 Claude 提出类似这样的请求：

• “读取此电子表格中的数据：https://docs.google.com/spreadsheets/d/...”
• “向 Sheet1 追加一行，包含今天的日期和 42”
• “这个工作簿中有哪些工作表？每个工作表有多少行？”
• “清除电子表格中的 B2:D10 范围”

---

安全说明

• .gitignore 会排除 credentials.json 和 token.json，切勿将它们提交到 Git
• OAuth 令牌存储在本地，且仅授予对你自己 Google 账号的访问权限
• 请求的权限范围：spreadsheets（读写）和 drive.readonly（用于解析工作表元数据）

---

许可证

MIT