---

name: google-sheets-automation description: "轻量级 Google Sheets 集成，带独立 OAuth 认证。无需 MCP 服务器。完整读写访问。" risk: critical source: community license: Apache-2.0 metadata: author: sanjay3290 version: "1.0"

Google Sheets

轻量级 Google Sheets 集成，带独立 OAuth 认证。无需 MCP 服务器。完整读写访问。

需要 Google Workspace 账户。 不支持个人 Gmail 账户。

首次设置

使用 Google 进行认证（打开浏览器）：

python scripts/auth.py login

检查认证状态：

python scripts/auth.py status

需要时登出：

python scripts/auth.py logout

读取命令

所有操作通过 scripts/sheets.py。首次使用时如未登录会自动认证。

# Get spreadsheet content as plain text (default)
python scripts/sheets.py get-text SPREADSHEET_ID

# Get spreadsheet content as CSV
python scripts/sheets.py get-text SPREADSHEET_ID --format csv

# Get spreadsheet content as JSON
python scripts/sheets.py get-text SPREADSHEET_ID --format json

# Get values from a specific range (A1 notation)
python scripts/sheets.py get-range SPREADSHEET_ID "Sheet1!A1:D10"
python scripts/sheets.py get-range SPREADSHEET_ID "A1:C5"

# Find spreadsheets by search query
python scripts/sheets.py find "budget 2024"
python scripts/sheets.py find "sales report" --limit 5

# Get spreadsheet metadata (sheets, dimensions, etc.)
python scripts/sheets.py get-metadata SPREADSHEET_ID

写入命令

# Update a range of cells with values (JSON 2D array)
python scripts/sheets.py update-range SPREADSHEET_ID "Sheet1!A1:B2" '[["Hello","World"],["Foo","Bar"]]'

# Update with RAW input (no formula parsing, treats everything as literal text)
python scripts/sheets.py update-range SPREADSHEET_ID "Sheet1!A1:B1" '[["=SUM(A1:A5)","text"]]' --raw

# Append rows after the last data row
python scripts/sheets.py append-rows SPREADSHEET_ID "Sheet1!A:Z" '[["New Row Col A","New Row Col B"]]'

# Clear values from a range (keeps formatting)
python scripts/sheets.py clear-range SPREADSHEET_ID "Sheet1!A1:B10"

# Batch update (advanced - for formatting, merging, etc.)
python scripts/sheets.py batch-update SPREADSHEET_ID '[{"updateCells":{"range":{"sheetId":0},"fields":"userEnteredValue"}}]'

电子表格 ID

你可以使用以下任一方式：

• 电子表格 ID：1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms
• 完整 URL：https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms/edit

脚本会自动从 URL 中提取 ID。

输出格式

文本（默认）

带管道分隔符的人类可读格式：

Spreadsheet Title: Sales Data
Sheet Name: Q1
Name | Revenue | Units
Product A | 10000 | 50
Product B | 15000 | 75

CSV

标准 CSV 格式，适合进一步处理：

Name,Revenue,Units
Product A,10000,50
Product B,15000,75

JSON

结构化数据格式：

{
  "Q1": [
    ["Name", "Revenue", "Units"],
    ["Product A", "10000", "50"]
  ]
}

A1 表示法示例

• Sheet1!A1:B10 - Sheet1 上 A1 到 B10 的范围
• Sheet1!A:A - Sheet1 上 A 列的全部
• Sheet1!1:1 - Sheet1 上第 1 行的全部
• A1:C5 - 第一个工作表上的范围

值输入选项

• USER_ENTERED（默认）：值按用户输入方式解析。数字、日期和公式会被解释。
• RAW（--raw 标志）：值按原样存储。不解析公式或数字格式。

令牌管理

令牌使用系统密钥环安全存储：

• macOS：Keychain
• Windows：Windows Credential Locker
• Linux：Secret Service API（GNOME Keyring、KDE Wallet 等）

服务名称：google-sheets-skill-oauth

令牌过期时使用 Google 的云函数自动刷新。

何时使用

当处理与上述主要领域或功能相关的任务时使用此技能。

限制

• 仅在任务明确匹配上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果所需输入、权限、安全边界或成功标准缺失，请停下来要求澄清。