MCP Reference: sheetsmcp.googleapis.com

這是 MCP 伺服器，提供與 Google 試算表互動的工具。

Model Context Protocol (MCP) 伺服器可做為代理伺服器，在外部服務與大型語言模型 (LLM) 或 AI 應用程式之間傳遞脈絡、資料或功能。MCP 伺服器會將 AI 應用程式連線至資料庫和 Web 服務等外部系統，並將系統回覆內容轉換成 AI 應用程式可理解的格式。

MCP 工具

MCP 工具是 MCP 伺服器向 LLM 或 AI 應用程式公開的函式或可執行功能，可在現實世界中執行動作。

工具

sheetsmcp.googleapis.com MCP 伺服器提供下列工具：

MCP 工具
get_values 從試算表傳回一系列值。對應 REST API 中的 spreadsheets.values.get：https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get
get_spreadsheet 傳回指定試算表的內容。傳回指定試算表 ID 的標題、工作表名稱、格線屬性和其他中繼資料。如果要求，也會傳回完整格線資料。對應 REST API 中的 spreadsheets.get：https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get
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：更新 Slicer 的規格。
  • addDataSource：新增資料來源。
  • updateDataSource：更新資料來源。
  • deleteDataSource：刪除資料來源。
  • refreshDataSource：重新整理一或多個資料來源和相關聯的 dbobject。
  • cancelDataSourceRefresh：取消一或多個資料來源和相關聯 dbobject 的重新整理作業。
  • addTable：新增表格。
  • updateTable：更新資料表。
  • deleteTable：刪除資料表的要求。
update_values 在試算表範圍中設定值。對應 REST API 中的 spreadsheets.values.update：https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
update_formulas 在試算表範圍中設定公式。對應 REST API 中的 spreadsheets.values.update：https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
insert_dimension 在工作表的特定索引處插入列或欄。對應於 spreadsheets.batchUpdate REST API 中的 InsertDimensionRequest：https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

取得 MCP 工具規格

如要取得 MCP 伺服器中所有工具的 MCP 工具規格，請使用 tools/list 方法。下列範例說明如何使用 curl 列出 MCP 伺服器中目前可用的所有工具及其規格。

Curl 要求 
curl --location 'https://sheetsmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'