AI导哈

电子表格操作服务器

Google Spreadsheet MCP Server 是一个用于操作Google电子表格的服务器，支持从AI代理如Claude Code进行电子表格的读写和管理操作。

  • by CHIHI913
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 CHIHI913/google-spreadsheet-mcp

使用说明

谷歌电子表格MCP服务器

Google 使用电子表格MCP (Model Context Protocol) 服务器。 Claude Code 等AI 代理允许读写电子表格。

机能

数据操作

工具｜说明｜ |--------|------| | get_sheet_metadata 获取电子表格的标题和工作表（选项卡）列表 | read_values ｜读取指定范围的数据｜ | append_values 在指定范围的末尾追记数据 | update_values ｜覆盖更新指定范围的数据｜

工作表管理

工具｜说明｜ |--------|------| | add_sheet 添加新工作表（选项卡） | delete_sheet 删除工作表（标签） | rename_sheet 重命名工作表（选项卡）

行列操作

工具｜说明｜ |--------|------| | insert_rows 在指定位置插入空行 | insert_columns 在指定位置插入空列 | delete_rows ｜删除指定范围的行｜ | delete_columns ｜删除指定范围的列｜

入力规则

工具｜说明｜ |--------|------| | set_dropdown 设置下拉列表（固定值） | set_dropdown_range 设置下拉列表（参考单元格范围） | set_checkbox 设置复选框 | get_validations 获取输入规则列表 | delete_validation ｜删除指定范围的输入规则｜

条件格式

工具｜说明｜ |--------|------| | add_conditional_format 使用自定义公式添加条件格式 | get_conditional_formats 获取条件格式规则列表 | delete_conditional_format 删除指定索引的条件格式

安装，安装

1. GCP 项目设置

  1. 谷歌云控制台 在中创建项目
  2. 谷歌网页API 启用
    APIs & Services → Enable APIs → 「Google Sheets API」を検索 → 有効化

2. OAuth 客户机ID 制作

  1. API和服务→ 凭证→ 创建凭据→ OAuth客户端ID
  2. 应用程序类型： 网络应用程序
  3. 输入名称（例如： sheets-mcp）
  4. 批准的重定向URI: http://localhost:8080/callback 添加
  5. Create → JSON 下载- credentials/client_secret.json 保存为

3.构建

pnpm install
pnpm run build

4. Claude Code 设定

.mcp.json 在项目根目录中创建：

{
  "mcpServers": {
    "google-spreadsheet": {
      "command": "node",
      "args": ["/path/to/google-spreadsheet-mcp/dist/index.js"],
      "env": {
        "CLIENT_SECRET_PATH": "/path/to/credentials/client_secret.json",
        "TOKEN_PATH": "/path/to/credentials/token.json"
      }
    }
  }
}

5.初回认证

首次启动时浏览器打开Google 系统将提示您验证帐户。 认证后，令牌 TOKEN_PATH 而需要与环境混合的每条反射光线，进行环境采样。

备注：我的Google 您可以使用已访问的所有电子表格进行验证。

使用例

获取工作表信息

https://docs.google.com/spreadsheets/d/xxx/edit のシート情報を取得して

导入数据

このスプレッドシートのシート1 A1:C10 を読み込んで

添加数据

シート1 に以下のデータを追加して:
- 山田, 25, エンジニア
- 佐藤, 30, デザイナー

更新数据

A1:B2 を以下に更新して:
- 名前, 年齢
- 田中, 28

添加工作表

「売上データ」という名前のシートを追加して

重命名工作表

シート1 を「顧客リスト」に名前変更して

设置下拉列表

D列にドロップダウンを設定して。選択肢は「承認」「却下」「保留」

复选框

E列にチェックボックスを設定して

添加条件格式

D列が「承認」の場合は行全体を緑色にして

制限事项

  • 不支持创建新电子表格
  • 格式仅支持自定义公式中的条件格式（不支持字体更改等）

相关 MCP