MCP Tools Reference: sheetsmcp.googleapis.com

Outil : get_spreadsheet

Renvoie le contenu de la feuille de calcul pour la feuille de calcul donnée. Renvoie les titres, les noms de feuilles, les propriétés de grille et d'autres métadonnées pour l'ID de feuille de calcul donné. Renvoie également les données de grille complètes si elles sont demandées. Correspond à spreadsheets.get dans l'API REST : https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP get_spreadsheet.

Requête Curl 
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
}'

Schéma d'entrée

GetContentRequest

Représentation JSON 
{
  "spreadsheetId": string,
  "includeGridData": boolean
}
Champs
spreadsheetId

string

Obligatoire. ID de la feuille de calcul à demander.
includeGridData

boolean

True si les données de grille doivent être renvoyées.

Schéma de sortie

Représente un objet JSON.

Carte clé-valeur non ordonnée, destinée à capturer parfaitement la sémantique d'un objet JSON. Cela permet d'analyser n'importe quelle charge utile JSON arbitraire en tant que champ de message au format ProtoJSON.

Cela suit les consignes de la RFC 8259 pour un JSON interopérable. Ce type ne peut notamment pas représenter de grandes valeurs Int64 ni les nombres NaN/Infinity, car le format JSON n'accepte généralement pas ces valeurs dans son type de nombre.

Si vous n'avez pas l'intention d'analyser un JSON arbitraire dans votre message, il est préférable d'utiliser un message typé personnalisé plutôt que ce type.

Struct

Représentation JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Champs
fields

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

Carte non ordonnée de valeurs typées de manière dynamique.

Objet contenant une liste de "key": value paires. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Représentation JSON 
{
  "key": string,
  "value": value
}
Champs
key

string
value

value (Value format)

Valeur

Représentation JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Champs
Champ d'union kind. Type de valeur. kind ne peut être qu'un des éléments suivants :
nullValue

null

Représente un JSON null.
numberValue

number

Représente un nombre JSON. Ne doit pas être NaN, Infinity ni -Infinity, car ces valeurs ne sont pas acceptées au format JSON. Cela ne peut pas non plus représenter de grandes valeurs Int64, car le format JSON ne les accepte généralement pas dans son type de nombre.
stringValue

string

Représente une chaîne JSON.
boolValue

boolean

Représente une valeur booléenne JSON (littéral true ou false au format JSON).
structValue

object (Struct format)

Représente un objet JSON.
listValue

array (ListValue format)

Représente un tableau JSON.

ListValue

Représentation JSON 
{
  "values": [
    value
  ]
}
Champs
values[]

value (Value format)

Champ répété de valeurs typées de manière dynamique.

NullValue

Représente un JSON null.

NullValue est un sentinelle qui utilise une énumération avec une seule valeur pour représenter la valeur nulle de l'union de type Value.

Un champ de type NullValue avec une valeur autre que 0 est considéré comme non valide. La plupart des sérialiseurs ProtoJSON émettent une Value avec une null_value définie comme un JSON null, quelle que soit la valeur entière, et effectuent donc un aller-retour vers une valeur 0.

Enums
NULL_VALUE Valeur nulle.

Annotations d'outil

Indication destructive : ❌ | Indication idempotente : ✅ | Indication en lecture seule : ✅ | Indication Open World : ✅