MCP Tools Reference: sheetsmcp.googleapis.com

Tool: get_spreadsheet

Gibt den Tabelleninhalt für die angegebene Tabelle zurück. Gibt Titel, Blattnamen, Rastereigenschaften und andere Metadaten für die angegebene Tabellen-ID zurück. Auf Anfrage werden auch vollständige Rasterdaten zurückgegeben. Entspricht spreadsheets.get in der REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get

Im folgenden Beispiel wird gezeigt, wie Sie curl verwenden, um das MCP-Tool get_spreadsheet aufzurufen.

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": "get_spreadsheet",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

GetContentRequest

JSON-Darstellung 
{
  "spreadsheetId": string,
  "includeGridData": boolean
}
Felder
spreadsheetId

string

Erforderlich. Die ID der Tabelle, die angefordert werden soll.
includeGridData

boolean

„True“, wenn Rasterdaten zurückgegeben werden sollen.

Ausgabeschema

Stellt ein JSON-Objekt dar.

Eine ungeordnete Schlüssel/Wert-Zuordnung, die die Semantik eines JSON-Objekts perfekt erfasst. Dadurch 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 kein beliebiges JSON in Ihre Nachricht parsen möchten, 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. Außerdem können damit keine großen Int64-Werte dargestellt werden, da das JSON-Format diese in seinem Zahlentyp im Allgemeinen 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 ein Enum mit nur einem Wert verwendet, um den Nullwert für die Value-Typ-Union darzustellen.

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

Enums
NULL_VALUE Nullwert.

Toolanmerkungen

Destruktiver Hinweis: ❌ | Hinweis auf Idempotenz: ✅ | Hinweis auf Schreibschutz: ✅ | Hinweis auf offene Welt: ✅