MCP Tools Reference: sheetsmcp.googleapis.com

Herramienta: get_values

Devuelve un rango de valores de una hoja de cálculo. Corresponde a spreadsheets.values.get en la API de REST: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta MCP get_values.

Solicitud curl 
curl --location 'https://sheetsmcp.googleapis.com/mcp' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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
}'

Esquema de entrada

GetValuesRequest

Representación JSON 
{
  "spreadsheetId": string,
  "range": string
}
Campos
spreadsheetId

string

Obligatorio. Es el ID de la hoja de cálculo de la que se recuperarán los datos.
range

string

Obligatorio. La notación A1 o notación R1C1 del rango del que se recuperarán los valores.

Esquema de salida

Datos dentro de un rango de la hoja de cálculo. https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values

ValueRange

Representación JSON 
{
  "range": string,
  "values": [
    array
  ]
}
Campos
range

string

Es el rango que abarcan los valores, en notación A1.
values[]

array (ListValue format)

Son los datos que se leyeron. Es un array de arrays. El array externo representa todos los datos, y cada array interno representa una fila. Cada elemento del array interno corresponde a una celda. No se incluirán las filas y columnas finales vacías.

ListValue

Representación JSON 
{
  "values": [
    value
  ]
}
Campos
values[]

value (Value format)

Es un campo repetido de valores con tipo dinámico.

Valor

Representación JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Campos
Campo de unión kind. Es el tipo de valor. kind puede ser solo uno de los parámetros siguientes:
nullValue

null

Representa un valor null de JSON.
numberValue

number

Representa un número JSON. No debe ser NaN, Infinity ni -Infinity, ya que no se admiten en JSON. Tampoco puede representar valores Int64 grandes, ya que el formato JSON, por lo general, no los admite en su tipo de número.
stringValue

string

Representa una cadena JSON.
boolValue

boolean

Representa un valor booleano JSON (literal true o false en JSON).
structValue

object (Struct format)

Representa un objeto JSON.
listValue

array (ListValue format)

Representa un array JSON.

Struct

Representación JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Campos
fields

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

Es un mapa no ordenado de valores con tipo dinámico.

Un objeto que contiene una lista de "key": value pares. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representación JSON 
{
  "key": string,
  "value": value
}
Campos
key

string
value

value (Value format)

NullValue

Representa un valor null de JSON.

NullValue es un centinela que usa un enum con un solo valor para representar el valor nulo de la unión de tipo Value.

Un campo de tipo NullValue con cualquier valor que no sea 0 se considera no válido. La mayoría de los serializadores ProtoJSON emitirán un Value con un null_value establecido como un valor null de JSON, independientemente del valor entero, y, por lo tanto, realizará un viaje de ida y vuelta a un valor 0.

Enums
NULL_VALUE Valor nulo.

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ✅

Alcances de la autorización

Se necesita uno de los siguientes alcances de OAuth:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/spreadsheets.readonly
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets