谷歌电子表格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 项目设置
- 谷歌云控制台 在中创建项目
- 谷歌网页API 启用
APIs & Services → Enable APIs → 「Google Sheets API」を検索 → 有効化2. OAuth 客户机ID 制作
- API和服务→ 凭证→ 创建凭据→ OAuth客户端ID
- 应用程序类型： 网络应用程序
- 输入名称（例如：
sheets-mcp） - 批准的重定向URI:
http://localhost:8080/callback添加 - Create → JSON 下载-
credentials/client_secret.json保存为
3.构建
pnpm install
pnpm run build4. 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列が「承認」の場合は行全体を緑色にして制限事项
- 不支持创建新电子表格
- 格式仅支持自定义公式中的条件格式（不支持字体更改等）