AI导哈

Google Sheets管理工具

通过Model Context Protocol提供23种工具来读取、写入、格式化和管理Google Sheets电子表格的服务。

  • by node2flow-th
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 node2flow-th/google-sheets-mcp-community

使用说明

@node2flow/google表单mcp

MCP服务器 谷歌表格 --通过模型上下文协议，使用23个工具读取、写入、格式化和管理电子表格。

快速开始

克劳德桌面/光标

添加到MCP配置中：

{
  "mcpServers": {
    "google-sheets": {
      "command": "npx",
      "args": ["-y", "@node2flow/google-sheets-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

HTTP模式

GOOGLE_CLIENT_ID=xxx GOOGLE_CLIENT_SECRET=xxx GOOGLE_REFRESH_TOKEN=xxx npx @node2flow/google-sheets-mcp --http

MCP端点： http://localhost:3000/mcp

Cloudflare工作人员

可用网址： https://google-sheets-mcp-community.node2flow.net/mcp

POST https://google-sheets-mcp-community.node2flow.net/mcp?GOOGLE_CLIENT_ID=xxx&GOOGLE_CLIENT_SECRET=xxx&GOOGLE_REFRESH_TOKEN=xxx

工具（23）

电子表格（2）

工具 说明
gs_create_spreadsheet 创建一个带有标题和可选工作表的新电子表格
gs_get_spreadsheet 获取元数据——工作表名称、ID、属性

数值（6）

工具 说明
gs_read_values 从A1范围读取单元格值
gs_batch_read 一次读取多个范围
gs_write_values 将值写入范围（二维数组）
gs_append_values 在现有数据后追加行
gs_clear_values 清除范围内的值（保持格式）
gs_batch_write 一次写入多个范围

表单管理（5）

工具 说明
gs_add_sheet 添加新工作表/选项卡
gs_delete_sheet 删除工作表/选项卡（不可逆）
gs_rename_sheet 重命名图纸/选项卡
gs_copy_sheet 将工作表复制到另一个电子表格
gs_duplicate_sheet 同一电子表格中的重复工作表

格式化（4）

工具 说明
gs_format_cells 粗体、斜体、颜色、字体、对齐方式、数字格式
gs_merge_cells 合并某个范围内的单元格
gs_unmerge_cells 取消合并单元格
gs_auto_resize 自动调整列宽或行高

数据操作（4）

工具 说明
gs_sort_range 按列排序范围
gs_find_replace 查找和替换文本（支持正则表达式）
gs_set_basic_filter 设置或清除纸张上的自动过滤器
gs_add_protected_range 保护范围免受编辑

高级（2）

工具 说明
gs_add_chart 添加图表（条形图、折线图、柱状图、散点图等）
gs_batch_update 任何操作的原始批更新

A1符号

范围使用A1符号表示值工具：

Sheet1!A1:C10    — specific range in Sheet1
Sheet1           — entire sheet
A:C              — columns A through C (first sheet)
Sheet1!A1:A      — column A, all rows
Sheet1!1:5       — rows 1 through 5

索引符号

格式化和批更新工具使用基于0的索引：

Row 1    → index 0      Column A → index 0
Row 2    → index 1      Column B → index 1
Row 10   → index 9      Column Z → index 25

范围包括 包容性开始，排他性结束:

  • startRowIndex: 0, endRowIndex: 5 =第1-5行
  • startColumnIndex: 0, endColumnIndex: 3 =A-C列

配置

参数 必填 说明
GOOGLE_CLIENT_ID 是 来自谷歌云控制台的OAuth 2.0客户端ID
GOOGLE_CLIENT_SECRET 是 OAuth 2.0客户端密码
GOOGLE_REFRESH_TOKEN 是 刷新令牌（通过OAuth同意流获得）

获取您的凭据

  1. 首选 谷歌云控制台
  2. 创建项目→ 启用 谷歌网页API
  3. 创建 OAuth 2.0客户端ID （桌面应用程序类型）
  4. 使用 OAuth游乐场 或者您的应用程序获取具有作用域的刷新令牌 https://www.googleapis.com/auth/spreadsheets

OAuth范围

范围 访问
spreadsheets 完全读/写访问
spreadsheets.readonly 只读访问

许可证

MIT许可证-请参阅 许可证

版权所有（c）2026 Node2Flow

链接

相关 MCP