gogcli-mcp-sheets

gogcli-mcp-sheets

警告

由 AI 开发的项目。 此代码库由 Claude Code 构建并积极维护。使用前请检查所有代码和工具权限。

通过 gogcli 扩展的 Google Sheets MCP 服务。包含身份验证工具，以及另外 55 个专用 Sheets 工具，用于标签页管理、格式设置、命名范围、Connected Sheets 等。

要求

• 已安装并完成身份验证的 gogcli
• Node.js 22+

brew install gogcli
gog auth add [email protected] --services sheets

安装

npm install -g gogcli-mcp-sheets

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "gogcli-sheets": {
      "command": "gogcli-mcp-sheets",
      "env": {
        "GOG_ACCOUNT": "[email protected]"
      }
    }
  }
}

Claude Code

claude mcp add gogcli-sheets -- gogcli-mcp-sheets

额外的 Sheets 工具（59 个）

另有 8 个身份验证工具和 8 个基础 Sheets 工具（get、update、append、clear、metadata、create、find-replace、run），总计 75 个。

工具	描述
gog_sheets_add_tab	添加新的工作表标签
gog_sheets_delete_tab	删除工作表标签
gog_sheets_rename_tab	重命名工作表标签
gog_sheets_copy	将工作表复制到另一个电子表格
gog_sheets_export	导出为 CSV、TSV、XLSX、PDF、ODS 或 HTML
gog_sheets_freeze	冻结行和/或列
gog_sheets_insert	插入行或列
gog_sheets_merge	合并单元格
gog_sheets_unmerge	拆分单元格
gog_sheets_format	应用单元格格式（粗体、颜色等）
gog_sheets_number_format	设置数字格式（货币、百分比、日期等）
gog_sheets_read_format	读取单元格格式
gog_sheets_resize_columns	调整列宽或自动适应
gog_sheets_resize_rows	调整行高或自动适应
gog_sheets_named_ranges_list	列出命名范围
gog_sheets_named_ranges_get	按名称或 ID 获取命名范围
gog_sheets_named_ranges_add	创建命名范围
gog_sheets_named_ranges_update	更新命名范围
gog_sheets_named_ranges_delete	删除命名范围
gog_sheets_notes	读取单元格备注
gog_sheets_update_note	添加或更新单元格备注
gog_sheets_links	列出范围内的超链接
gog_sheets_links_set	一次调用（批量）设置 =HYPERLINK() 单元格
gog_sheets_snapshot	在进行高风险编辑前备份整个电子表格
gog_sheets_datasource_list	列出 Connected Sheets 数据源（BigQuery / Looker），包括工作表和执行状态
gog_sheets_datasource_describe	数据源完整规范，包括其查询、状态和刷新计划
gog_sheets_datasource_table_list	列出锚定的数据源表（提取数据）及其 A1 锚点
gog_sheets_datasource_table_describe	描述锚定在 A1 单元格的提取数据
gog_sheets_datasource_table_read	从提取数据中读取指定上限行数
gog_sheets_datasource_add	添加 BigQuery Connected Sheets 数据源（自定义 SQL 或原生表）
gog_sheets_datasource_update	更改数据源的 SQL、表或结算项目
gog_sheets_datasource_refresh	重新运行数据源，使其工作表和提取数据获取最新数据
gog_sheets_datasource_delete	删除数据源及其关联工作表，并解除依赖对象的关联
gog_sheets_list_tabs	列出电子表格中的标签（sheetId、标题、索引、gridProperties）
gog_sheets_copy_paste	将某个范围的值/公式/格式复制到另一个范围（平铺以向下/向右填充）。
gog_sheets_validation_get	读取范围上的数据验证规则（下拉菜单、复选框、条件）。
gog_sheets_validation_set	为范围设置数据验证规则：下拉菜单、复选框、数字/日期条件或自定义公式。
gog_sheets_validation_clear	移除范围内的所有数据验证规则。
gog_sheets_delete_dimension	删除一段行或列，并识别表格：相交的表格会缩小，同时保留剩余数据。
gog_sheets_batch_update	通过一次 Sheets API 请求，以原子方式更新多个范围中的值。
gog_sheets_reorder_tab	将标签移动到指定的从 0 开始的位置。
gog_sheets_chart_list	列出电子表格中的嵌入式图表。
gog_sheets_chart_get	按图表 ID 获取图表的完整定义（规范 + 位置）。
gog_sheets_chart_create	根据 JSON ChartSpec 创建嵌入式图表。
gog_sheets_chart_update	按图表 ID 替换图表规范。
gog_sheets_chart_delete	按图表 ID 删除图表。
gog_sheets_table_list	列出电子表格中的 Google Sheets 表格。
gog_sheets_table_get	按表格 ID 获取 Google Sheets 表格。
gog_sheets_table_create	在某个范围上创建包含类型化列的 Google Sheets 表格。
gog_sheets_table_append	向表格追加数据行。
gog_sheets_table_clear	清除表格中的所有数据行。
gog_sheets_table_delete	删除 Google Sheets 表格。默认保留表格的单元格值和公式（模拟“转换为范围”）；设置 keep_data=false 也会清除数据。
gog_sheets_banding_list	列出交替颜色的带状范围。
gog_sheets_banding_set	为范围应用交替颜色。
gog_sheets_banding_clear	按 ID 或针对整个工作表移除交替颜色带状格式。
gog_sheets_filter_set	在范围上设置基本筛选条件；替换现有筛选条件需要设置 replace=true。
gog_sheets_conditional_format_list	列出条件格式规则。
gog_sheets_conditional_format_add	为范围添加条件格式规则（布尔值或渐变）。
gog_sheets_conditional_format_clear	移除工作表中的条件格式规则。

License

MIT