gmickel/sheets-cli

Sheets-CLI

面向人类和代理的可组合 Google 表格原语

安装 • 快速入门 • 指挥 • 对于代理人

---

** 📢 新项目：** 看看 GNO —— 本地混合搜索你的文档（Markdown、PDF、Word、Excel）。结合了 BM25 + 矢量搜索与 MCP 集成，用于 AI 代理。非常适合 sheets-cli 的辅助工具：搜索本地文档，查询 Cloud Sheets。

---

快速、确定性的 Google 表格 CLI。读取表、添加行、按键或索引更新单元格、批处理操作——所有这些都支持 JSON 输出，供程序化使用。

** 代理🆕技能** — 安装为Claude Code、OpenAI代码或VS Code（内部预览;启用chat.useAgentSkills）的技能。当你提到电子表格时，代理会自动发现sheets-cli。参见代理。

安装

前提条件： Bun 运行时间

添加到PATH

快速启动

1.启用 API

1. 访问 Google Cloud 控制台 → API
2. 启用Google Sheets API
3. 启用 Google Drive API（sheets find 命令所需）

2.创建OAuth凭证

1. 访问Google Cloud Console →凭证
2. 创建OAuth 2.0客户端ID →桌面应用

sheets-cli

Composable Google Sheets primitives for humans and agents

Installation • Quick Start • Commands • For Agents

---

📢 New Project: Check out GNO — local hybrid search for your documents (Markdown, PDF, Word, Excel). Combines BM25 + vector search with MCP integration for AI agents. Great companion to sheets-cli: search your local docs, query your cloud sheets.

---

Fast, deterministic CLI for Google Sheets. Read tables, append rows, update cells by key or index, batch operations—all with JSON output for programmatic consumption.

# Read a sheet as structured data
sheets-cli read table --sheet "Projects" --limit 10

# Update by key column (no fragile row indices)
sheets-cli update key --sheet "Projects" --key-col "Name" --key "Acme" --set '{"Status":"Done"}'

🆕 Agent Skills — Install as a skill for Claude Code, OpenAI Codex, or VS Code (Insiders preview; enable chat.useAgentSkills). The agent automatically discovers sheets-cli when you mention spreadsheets. See For Agents.

Installation

Prerequisites: Bun runtime

git clone https://github.com/gmickel/sheets-cli.git
cd sheets-cli
bun install
bun run build

# Binary at ./dist/sheets-cli

Quick Start

1. Enable APIs

1. Go to Google Cloud Console → APIs
2. Enable Google Sheets API
3. Enable Google Drive API (required for sheets find command)

2. Create OAuth Credentials