MCP Tools Reference: sheetsmcp.googleapis.com

工具：update_formulas

在电子表格的某个范围内设置公式。对应于 REST API 中的 spreadsheets.values.update：https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update

以下示例演示了如何使用 curl 调用 update_formulas MCP 工具。

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

输入架构

UpdateFormulasRequest

JSON 表示法 
{
  "spreadsheetId": string,
  "range": string,
  "formulas": [
    array
  ]
}
字段
spreadsheetId

string

必需。要更新的电子表格的 ID。
range

string

必需。要更新的值的 A1 表示法。
formulas[]

array (ListValue format)

必需。已读取或要写入的数据。这是一个由数组组成的数组，外部数组表示所有数据，每个内部数组表示一行。内部数组中的每个项都对应一个单元格。支持的值类型包括：bool、string 和 double。系统会跳过 null 值。如需将单元格设置为空值，请将字符串值设置为空字符串。

ListValue

JSON 表示法 
{
  "values": [
    value
  ]
}
字段
values[]

value (Value format)

动态类型值的重复字段。

Value

JSON 表示法 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
字段
联合字段 kind。值的类型。kind 只能是下列其中一项：
nullValue

null

表示 JSON null。
numberValue

number

表示 JSON 数字。不得为 NaN、Infinity 或 -Infinity，因为 JSON 不支持这些值。此值也不能表示较大的 Int64 值，因为 JSON 格式通常不支持其数字类型中的这些值。
stringValue

string

表示 JSON 字符串。
boolValue

boolean

表示 JSON 布尔值（JSON 中的 true 或 false 字面量）。
structValue

object (Struct format)

表示 JSON 对象。
listValue

array (ListValue format)

表示 JSON 数组。

Struct

JSON 表示法 
{
  "fields": {
    string: value,
    ...
  }
}
字段
fields

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

动态类型值的无序映射。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

FieldsEntry

JSON 表示法 
{
  "key": string,
  "value": value
}
字段
key

string
value

value (Value format)

NullValue

表示 JSON null。

NullValue 是一个标记，使用仅包含一个值的枚举来表示 Value 类型联合的 null 值。

如果类型为 NullValue 的字段的值不是 0，则该字段被视为无效。大多数 ProtoJSON 序列化程序都会发出一个 Value，其中 null_value 设置为 JSON null，无论整数值如何，都会往返于 0 值。

枚举
NULL_VALUE Null 值。

输出架构

表示 JSON 对象。

无序键值对映射，旨在完美捕获 JSON 对象的语义。这样一来，您就可以将任何任意 JSON 载荷解析为 ProtoJSON 格式的消息字段。

这遵循了 RFC 8259 中关于可互操作 JSON 的准则：值得注意的是，此类型不能表示较大的 Int64 值或 NaN/Infinity 数字，因为 JSON 格式通常不支持其数字类型中的这些值。

如果您不打算将任意 JSON 解析到消息中，则应首选自定义类型消息，而不是使用此类型。

Struct

JSON 表示法 
{
  "fields": {
    string: value,
    ...
  }
}
字段
fields

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

动态类型值的无序映射。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

FieldsEntry

JSON 表示法 
{
  "key": string,
  "value": value
}
字段
key

string
value

value (Value format)

Value

JSON 表示法 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
字段
联合字段 kind。值的类型。kind 只能是下列其中一项：
nullValue

null

表示 JSON null。
numberValue

number

表示 JSON 数字。不得为 NaN、Infinity 或 -Infinity，因为 JSON 不支持这些值。此值也不能表示较大的 Int64 值，因为 JSON 格式通常不支持其数字类型中的这些值。
stringValue

string

表示 JSON 字符串。
boolValue

boolean

表示 JSON 布尔值（JSON 中的 true 或 false 字面量）。
structValue

object (Struct format)

表示 JSON 对象。
listValue

array (ListValue format)

表示 JSON 数组。

ListValue

JSON 表示法 
{
  "values": [
    value
  ]
}
字段
values[]

value (Value format)

动态类型值的重复字段。

NullValue

表示 JSON null。

NullValue 是一个标记，使用仅包含一个值的枚举来表示 Value 类型联合的 null 值。

如果类型为 NullValue 的字段的值不是 0，则该字段被视为无效。大多数 ProtoJSON 序列化程序都会发出一个 Value，其中 null_value 设置为 JSON null，无论整数值如何，都会往返于 0 值。

枚举
NULL_VALUE Null 值。

工具注释

破坏性提示：❌ | 等幂性提示：❌ | 只读提示：❌ | 开放世界提示：✅

授权范围

需要以下 OAuth 范围之一：

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