MCP Tools Reference: sheetsmcp.googleapis.com

Outil : get_values

Renvoie une plage de valeurs à partir d'une feuille de calcul. Correspond à spreadsheets.values.get dans l'API REST : https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get

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

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

Schéma d'entrée

GetValuesRequest

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

string

Obligatoire. ID de la feuille de calcul à partir de laquelle récupérer les données.
range

string

Obligatoire. Notation A1 ou R1C1 de la plage à partir de laquelle récupérer les valeurs.

Schéma de sortie

Données dans une plage de la feuille de calcul. https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values

ValueRange

Représentation JSON 
{
  "range": string,
  "values": [
    array
  ]
}
Champs
range

string

Plage de valeurs, en notation A1.
values[]

array (ListValue format)

Données lues. Il s'agit d'un tableau de tableaux, le tableau externe représentant toutes les données et chaque tableau interne représentant une ligne. Chaque élément du tableau intérieur correspond à une cellule. Les lignes et colonnes vides à la fin ne seront pas incluses.

ListValue

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

value (Value format)

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

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 null JSON.
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. Il 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 numérique.
stringValue

string

Représente une chaîne JSON.
boolValue

boolean

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

object (Struct format)

Représente un objet JSON.
listValue

array (ListValue format)

Représente un tableau JSON.

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 paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

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

string
value

value (Value format)

NullValue

Représente un null JSON.

NullValue est une 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 un Value avec un null_value défini comme null JSON, quelle que soit la valeur entière, et effectuent donc un aller-retour vers une valeur 0.

Enums
NULL_VALUE Valeur nulle.

Annotations d'outils

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