MCP Tools Reference: sheetsmcp.googleapis.com

Tool: update_spreadsheet

Wendet eine oder mehrere Aktualisierungen auf die Tabelle an.

Entspricht „spreadsheets.batchUpdate“ in der REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate

Die Liste der möglichen Updates:

  • updateSpreadsheetProperties: Aktualisiert die Eigenschaften der Tabelle.
  • updateSheetProperties: Aktualisiert die Eigenschaften eines Blatts.
  • updateDimensionProperties: Aktualisiert die Attribute von Dimensionen.
  • updateNamedRange: Aktualisiert einen benannten Bereich.
  • repeatCell: Wiederholt eine einzelne Zelle in einem Bereich.
  • addNamedRange: Fügt einen benannten Bereich hinzu.
  • deleteNamedRange: Löscht einen benannten Bereich.
  • addSheet: Fügt ein Tabellenblatt hinzu.
  • deleteSheet: Löscht ein Tabellenblatt.
  • autoFill: Füllt automatisch weitere Daten basierend auf vorhandenen Daten ein.
  • cutPaste: Daten werden aus einem Bereich ausgeschnitten und in einen anderen eingefügt.
  • copyPaste: Kopiert Daten aus einem Bereich und fügt sie in einen anderen ein.
  • mergeCells: Zellen werden zusammengeführt.
  • unmergeCells: Hebt den Zellenverbund auf.
  • updateBorders: Aktualisiert die Rahmenlinien in einem Zellbereich.
  • updateCells: Aktualisiert viele Zellen gleichzeitig.
  • addFilterView: Fügt eine Filteransicht hinzu.
  • appendCells: Fügt Zellen nach der letzten Zeile mit Daten in einem Tabellenblatt an.
  • clearBasicFilter: Löscht den einfachen Filter in einem Tabellenblatt.
  • deleteDimension: Löscht Zeilen oder Spalten in einem Tabellenblatt.
  • deleteEmbeddedObject: Löscht ein eingebettetes Objekt (z. B. Diagramm, Bild) in einem Tabellenblatt.
  • deleteFilterView: Löscht eine Filteransicht aus einem Tabellenblatt.
  • duplicateFilterView: Dupliziert eine Filteransicht.
  • duplicateSheet: Dupliziert ein Tabellenblatt.
  • findReplace: Sucht nach Vorkommen von Text und ersetzt sie durch anderen Text.
  • insertDimension: Fügt neue Zeilen oder Spalten in ein Tabellenblatt ein.
  • insertRange: Fügt neue Zellen in ein Tabellenblatt ein und verschiebt die vorhandenen Zellen.
  • moveDimension: Verschiebt Zeilen oder Spalten an eine andere Stelle in einem Tabellenblatt.
  • updateEmbeddedObjectPosition: Aktualisiert die Position eines eingebetteten Objekts (z.B. Diagramm, Bild).
  • pasteData: Fügt Daten (HTML oder durch Trennzeichen getrennt) in ein Tabellenblatt ein.
  • textToColumns: Konvertiert eine Textspalte in mehrere Textspalten.
  • updateFilterView: Aktualisiert die Eigenschaften einer Filteransicht.
  • deleteRange: Löscht einen Zellenbereich aus einem Tabellenblatt und verschiebt die verbleibenden Zellen.
  • appendDimension: Fügt Dimensionen an das Ende eines Tabellenblatts an.
  • addConditionalFormatRule: Fügt eine neue Regel für die bedingte Formatierung hinzu.
  • updateConditionalFormatRule: Aktualisiert eine vorhandene Regel für bedingte Formatierung.
  • deleteConditionalFormatRule: Löscht eine vorhandene Regel für die bedingte Formatierung.
  • sortRange: Sortiert Daten in einem Bereich.
  • setDataValidation: Legt die Datenvalidierung für eine oder mehrere Zellen fest.
  • setBasicFilter: Legt den einfachen Filter für ein Tabellenblatt fest.
  • addProtectedRange: Fügt einen geschützten Bereich hinzu.
  • updateProtectedRange: Aktualisiert einen geschützten Bereich.
  • deleteProtectedRange: Löscht einen geschützten Bereich.
  • autoResizeDimensions: Die Größe einer oder mehrerer Dimensionen wird automatisch an den Inhalt der Zellen in dieser Dimension angepasst.
  • addChart: Fügt ein Diagramm hinzu.
  • updateChartSpec: Aktualisiert die Spezifikationen eines Diagramms.
  • updateBanding: Aktualisiert einen Bereich mit Bändern
  • addBanding: Fügt einen neuen Bereich mit Abstufungen hinzu.
  • deleteBanding: Entfernt einen Bereich mit Bändern.
  • createDeveloperMetadata: Erstellt neue Entwicklermetadaten
  • updateDeveloperMetadata: Aktualisiert einen vorhandenen Entwicklermetadateneintrag.
  • deleteDeveloperMetadata: Entwicklermetadaten löschen
  • randomizeRange: Mischt die Reihenfolge der Zeilen in einem Bereich.
  • addDimensionGroup: Erstellt eine Gruppe für den angegebenen Bereich.
  • deleteDimensionGroup: Löscht eine Gruppe im angegebenen Bereich.
  • updateDimensionGroup: Aktualisiert den Status der angegebenen Gruppe.
  • trimWhitespace: Entfernt Leerzeichen (z. B. Leerzeichen, Tabulatoren oder Zeilenumbrüche) aus Zellen.
  • deleteDuplicates: Entfernt Zeilen, die doppelte Werte in angegebenen Spalten eines Zellbereichs enthalten.
  • updateEmbeddedObjectBorder: Aktualisiert den Rahmen eines eingebetteten Objekts.
  • addSlicer: Fügt einen Datenschnitt hinzu.
  • updateSlicerSpec: Aktualisiert die Spezifikationen eines Slicers.
  • addDataSource: Fügt eine Datenquelle hinzu.
  • updateDataSource: Aktualisiert eine Datenquelle.
  • deleteDataSource: Löscht eine Datenquelle.
  • refreshDataSource: Aktualisiert eine oder mehrere Datenquellen und die zugehörigen Datenbankobjekte.
  • cancelDataSourceRefresh: Bricht Aktualisierungen einer oder mehrerer Datenquellen und der zugehörigen Datenbankobjekte ab.
  • addTable: Fügt eine Tabelle hinzu.
  • updateTable: Aktualisiert eine Tabelle.
  • deleteTable: Eine Anfrage zum Löschen einer Tabelle.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool update_spreadsheet aufrufen.

Curl-Anfrage 
curl --location 'https://sheetsmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "update_spreadsheet",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

UpdateContentRequest

JSON-Darstellung 
{
  "spreadsheetId": string,
  "requests": [
    {
      object
    }
  ]
}
Felder
spreadsheetId

string

Erforderlich. Die ID der zu aktualisierenden Tabelle.
requests[]

object (Struct format)

Erforderlich. Eine Liste der Aktualisierungen, die auf die Tabelle angewendet werden sollen. Jede Anfrage muss ein gültiges spreadsheets.batchUpdateRequest-Objekt sein, das dem Schema entspricht, das unter https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request dokumentiert ist. Anfragen werden in der angegebenen Reihenfolge angewendet. Wenn eine Anfrage ungültig ist, werden keine Anfragen angewendet.

Struct

JSON-Darstellung 
{
  "fields": {
    string: value,
    ...
  }
}
Felder
fields

map (key: string, value: value (Value format))

Ungeordnete Zuordnung von dynamisch typisierten Werten.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

JSON-Darstellung 
{
  "key": string,
  "value": value
}
Felder
key

string
value

value (Value format)

Wert

JSON-Darstellung 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Felder
Union-Feld kind. Die Art des Werts. Für kind ist nur einer der folgenden Werte zulässig:
nullValue

null

Stellt ein JSON-null dar.
numberValue

number

Stellt eine JSON-Zahl dar. Darf nicht NaN, Infinity oder -Infinity sein, da diese in JSON nicht unterstützt werden. Auch große Int64-Werte können nicht dargestellt werden, da das JSON-Format sie in seinem Zahlentyp generell nicht unterstützt.
stringValue

string

Stellt einen JSON-String dar.
boolValue

boolean

Stellt einen booleschen JSON-Wert dar (true- oder false-Literal in JSON).
structValue

object (Struct format)

Stellt ein JSON-Objekt dar.
listValue

array (ListValue format)

Stellt ein JSON-Array dar.

ListValue

JSON-Darstellung 
{
  "values": [
    value
  ]
}
Felder
values[]

value (Value format)

Wiederkehrendes Feld mit dynamisch typisierten Werten.

NullValue

Stellt ein JSON-null dar.

NullValue ist ein Sentinel, der einen Enum mit nur einem Wert verwendet, um den Nullwert für die Typunion Value darzustellen.

Ein Feld vom Typ NullValue mit einem anderen Wert als 0 wird als ungültig betrachtet. Die meisten ProtoJSON-Serialisierungsprogramme geben ein Value mit einem als JSON-null festgelegten null_value aus, unabhängig vom Ganzzahlwert, und führen so zu einem Roundtrip zu einem 0-Wert.

Enums
NULL_VALUE Nullwert.

Ausgabeschema

Stellt ein JSON-Objekt dar.

Eine ungeordnete Schlüssel/Wert-Zuordnung, die die Semantik eines JSON-Objekts perfekt erfassen soll. So kann eine beliebige JSON-Nutzlast als Nachrichtenfeld im ProtoJSON-Format geparst werden.

Dies entspricht den RFC 8259-Richtlinien für interoperables JSON. Insbesondere können mit diesem Typ keine großen Int64-Werte oder NaN-/Infinity-Zahlen dargestellt werden, da das JSON-Format diese Werte in seinem Zahlentyp im Allgemeinen nicht unterstützt.

Wenn Sie nicht vorhaben, beliebigen JSON-Code in Ihre Nachricht zu parsen, sollten Sie stattdessen eine benutzerdefinierte typisierte Nachricht verwenden.

Struct

JSON-Darstellung 
{
  "fields": {
    string: value,
    ...
  }
}
Felder
fields

map (key: string, value: value (Value format))

Ungeordnete Zuordnung von dynamisch typisierten Werten.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

JSON-Darstellung 
{
  "key": string,
  "value": value
}
Felder
key

string
value

value (Value format)

Wert

JSON-Darstellung 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Felder
Union-Feld kind. Die Art des Werts. Für kind ist nur einer der folgenden Werte zulässig:
nullValue

null

Stellt ein JSON-null dar.
numberValue

number

Stellt eine JSON-Zahl dar. Darf nicht NaN, Infinity oder -Infinity sein, da diese in JSON nicht unterstützt werden. Auch große Int64-Werte können nicht dargestellt werden, da das JSON-Format sie in seinem Zahlentyp generell nicht unterstützt.
stringValue

string

Stellt einen JSON-String dar.
boolValue

boolean

Stellt einen booleschen JSON-Wert dar (true- oder false-Literal in JSON).
structValue

object (Struct format)

Stellt ein JSON-Objekt dar.
listValue

array (ListValue format)

Stellt ein JSON-Array dar.

ListValue

JSON-Darstellung 
{
  "values": [
    value
  ]
}
Felder
values[]

value (Value format)

Wiederkehrendes Feld mit dynamisch typisierten Werten.

NullValue

Stellt ein JSON-null dar.

NullValue ist ein Sentinel, der einen Enum mit nur einem Wert verwendet, um den Nullwert für die Typunion Value darzustellen.

Ein Feld vom Typ NullValue mit einem anderen Wert als 0 wird als ungültig betrachtet. Die meisten ProtoJSON-Serialisierungsprogramme geben ein Value mit einem als JSON-null festgelegten null_value aus, unabhängig vom Ganzzahlwert, und führen so zu einem Roundtrip zu einem 0-Wert.

Enums
NULL_VALUE Nullwert.

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ❌ | Hinweis „Nur lesen“: ❌ | Hinweis „Offene Welt“: ✅