MCP Tools Reference: sheetsmcp.googleapis.com

工具：update_spreadsheet

对电子表格应用一项或多项更新。

对应于 REST API 中的 spreadsheets.batchUpdate：https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate

可能的更新列表如下：

• updateSpreadsheetProperties：更新电子表格的属性。
• updateSheetProperties：更新工作表的属性。
• updateDimensionProperties：更新维度的属性。
• updateNamedRange：更新命名的范围。
• repeatCell：在某个范围内重复单个单元格。
• addNamedRange：添加命名的范围。
• deleteNamedRange：删除指定范围。
• addSheet：添加工作表。
• deleteSheet：删除工作表。
• autoFill：根据现有数据自动填充更多数据。
• cutPaste：剪切某个区域的数据并将其粘贴到另一个区域。
• copyPaste：将数据从一个区域复制到另一个区域。
• mergeCells：将单元格合并在一起。
• unmergeCells：取消合并已合并的单元格。
• updateBorders：更新某个单元格范围内的边框。
• updateCells：一次更新多个单元格。
• addFilterView：添加过滤视图。
• appendCells：将单元格附加到工作表中包含数据的最后一行的后面。
• clearBasicFilter：清除工作表上的基本过滤条件。
• deleteDimension：删除工作表中的行或列。
• deleteEmbeddedObject：删除工作表中的嵌入式对象（例如图表、图片）。
• deleteFilterView：从工作表中删除过滤视图。
• duplicateFilterView：复制过滤视图。
• duplicateSheet：复制工作表。
• findReplace：查找并替换某些文本。
• insertDimension：在工作表中插入新行或新列。
• insertRange：在工作表中插入新单元格，并移动现有单元格。
• moveDimension：将行或列移到工作表中的其他位置。
• updateEmbeddedObjectPosition：更新嵌入式对象（例如图表、图片）的位置。
• pasteData：将数据（HTML 或分隔数据）粘贴到工作表中。
• textToColumns：将文本列转换为多个文本列。
• updateFilterView：更新过滤视图的属性。
• deleteRange：从工作表中删除某个范围的单元格，并移动剩余的单元格。
• appendDimension：将维度附加到工作表的末尾。
• addConditionalFormatRule：添加新的条件格式规则。
• updateConditionalFormatRule：更新现有的条件格式规则。
• deleteConditionalFormatRule：删除现有的条件格式规则。
• sortRange：对某个范围中的数据进行排序。
• setDataValidation：为一个或多个单元格设置数据验证。
• setBasicFilter：在工作表上设置基本过滤条件。
• addProtectedRange：添加受保护的范围。
• updateProtectedRange：更新受保护的范围。
• deleteProtectedRange：删除受保护的范围。
• autoResizeDimensions：根据相应维度中单元格的内容自动调整一个或多个维度的大小。
• addChart：添加图表。
• updateChartSpec：更新图表的规范。
• updateBanding：更新分段范围
• addBanding：添加新的分级范围
• deleteBanding：移除分段范围
• createDeveloperMetadata：创建新的开发者元数据
• updateDeveloperMetadata：更新现有的开发者元数据条目
• deleteDeveloperMetadata：删除开发者元数据
• randomizeRange：随机化某个范围内各行的顺序。
• addDimensionGroup：在指定范围内创建群组。
• deleteDimensionGroup：删除指定范围内的群组。
• updateDimensionGroup：更新指定群组的状态。
• trimWhitespace：去除单元格中的空格（例如空格、制表符或换行符）。
• deleteDuplicates：移除单元格范围的指定列中包含重复值的行。
• updateEmbeddedObjectBorder：更新嵌入式对象的边框。
• addSlicer：添加切片器。
• updateSlicerSpec：更新切片器的规范。
• addDataSource：添加数据源。
• updateDataSource：更新数据源。
• deleteDataSource：删除数据源。
• refreshDataSource：刷新一个或多个数据源及关联的数据库对象。
• cancelDataSourceRefresh：取消一个或多个数据源及关联的 dbobject 的刷新。
• addTable：添加表格。
• updateTable：更新表格。
• deleteTable：用于删除表的请求。

以下示例演示了如何使用 curl 调用 update_spreadsheet MCP 工具。

输入架构

{
  "spreadsheetId": string,
  "requests": [
    {
      object
    }
  ]
}

{
  "fields": {
    string: value,
    ...
  }
}

{
  "key": string,
  "value": value
}

{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}

{
  "values": [
    value
  ]
}

输出架构

{
  "fields": {
    string: value,
    ...
  }
}

{
  "key": string,
  "value": value
}

{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}

{
  "values": [
    value
  ]
}

工具注释

破坏性提示：❌ | 幂等性提示：❌ | 只读提示：❌ | 开放世界提示：✅

授权范围

需要以下 OAuth 范围之一：

• https://www.googleapis.com/auth/drive
• https://www.googleapis.com/auth/drive.file
• https://www.googleapis.com/auth/spreadsheets