MCP Reference: sheetsmcp.googleapis.com

これは、Google スプレッドシートを操作するためのツールを提供する MCP サーバーです。

Model Context Protocol(MCP)サーバーは、大規模言語モデル(LLM)または AI アプリケーションにコンテキスト、データ、機能を提供する外部サービスとの間のプロキシとして機能します。MCP サーバーは、AI アプリケーションをデータベースやウェブサービスなどの外部システムに接続し、そのレスポンスを 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

スプレッドシートに 1 つ以上の更新を適用します。

REST API の spreadsheets.batchUpdate に対応します: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate

更新できる内容は次のとおりです。

  • updateSpreadsheetProperties: スプレッドシートのプロパティを更新します。
  • updateSheetProperties: シートのプロパティを更新します。
  • updateDimensionProperties: ディメンションのプロパティを更新します。
  • updateNamedRange: 名前付き範囲を更新します。
  • repeatCell: 範囲全体に 1 つのセルを繰り返します。
  • 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: 1 つ以上のセルのデータ検証を設定します。
  • setBasicFilter: シートに基本フィルタを設定します。
  • addProtectedRange: 保護されている範囲を追加します。
  • updateProtectedRange: 保護されている範囲を更新します。
  • deleteProtectedRange: 保護されている範囲を削除します。
  • autoResizeDimensions: そのディメンションのセルの内容に基づいて、1 つ以上のディメンションのサイズを自動的に変更します。
  • addChart: グラフを追加します。
  • updateChartSpec: グラフの仕様を更新します。
  • updateBanding: バンド付き範囲を更新します
  • addBanding: 新しいバンド付き範囲を追加します
  • deleteBanding: バンド付き範囲を削除します
  • createDeveloperMetadata: 新しいデベロッパー メタデータを作成します
  • updateDeveloperMetadata: 既存のデベロッパー メタデータ エントリを更新します
  • deleteDeveloperMetadata: デベロッパー メタデータを削除します
  • randomizeRange: 範囲内の行の順序をランダム化します。
  • addDimensionGroup: 指定した範囲にグループを作成します。
  • deleteDimensionGroup: 指定した範囲のグループを削除します。
  • updateDimensionGroup: 指定したグループの状態を更新します。
  • trimWhitespace: セルから空白文字(スペース、タブ、改行など)を削除します。
  • deleteDuplicates: セル範囲の指定した列に重複する値を含む行を削除します。
  • updateEmbeddedObjectBorder: 埋め込みオブジェクトの罫線を更新します。
  • addSlicer: スライサーを追加します。
  • updateSlicerSpec: スライサーの仕様を更新します。
  • addDataSource: データソースを追加します。
  • updateDataSource: データソースを更新します。
  • deleteDataSource: データソースを削除します。
  • refreshDataSource: 1 つ以上のデータソースと関連する dbobject を更新します。
  • cancelDataSourceRefresh: 1 つ以上のデータソースと関連する 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
}'