К основному содержанию
скилл CX Codex

googlesheets-automation — скилл для Claude Code: читать, писать

Скилл googlesheets-automation для автоматизации работы с Google Sheets: чтение и запись данных, управление вкладками, форматирование ячеек, фильтрация строк. Работает через Rube MCP и требует активного подключения к Google.

MIT 128 установок ★ 3 785 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add davepoon/buildwithclaude --skill googlesheets-automation -a claude-code
Открыть на GitHub

Что делает googlesheets-automation

Скилл подключается к Google Sheets через Rube MCP (Composio) и открывает доступ к полному набору операций над таблицами. Можно читать и писать данные, создавать новые таблицы и вкладки, применять форматирование (жирный, цвета, размер шрифта), искать строки по значениям и обновлять или добавлять записи по уникальному ключу.

Для работы нужно добавить https://rube.app/mcp как MCP-сервер в конфигурацию клиента (API-ключи не требуются), затем подключить Google Sheets через RUBE_MANAGE_CONNECTIONS и пройти OAuth. Скилл использует инструменты вроде GOOGLESHEETS_BATCH_GET для чтения, GOOGLESHEETS_BATCH_UPDATE для записи, GOOGLESHEETS_UPSERT_ROWS для обновления по ключу и GOOGLESHEETS_FORMAT_CELL для форматирования.

Главное ограничение: диапазоны должны быть ограничены (например, Sheet1!A1:Z1000), иначе на больших таблицах может быть таймаут. Названия вкладок чувствительны к регистру, пустые диапазоны могут не вернуть поле values. Поиск по GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW ищет полное совпадение ячейки, не подстроки.

Какие задачи решает

  • синхронизировать данные между приложением и Google Sheets
  • заполнить таблицу данными из API или файла
  • отформатировать диапазон ячеек (цвет, шрифт, выравнивание)
  • найти и обновить строку по уникальному идентификатору
  • создать новую таблицу и добавить в неё вкладки

Примеры запросов агенту

  • Прочитай данные из таблицы Sales Report в диапазоне A1:D100
  • Напиши в Google Sheet tasks новую строку с колонками name, status, date
  • Обнови в таблице все строки, где email совпадает, добавь новые если нет

Как установить googlesheets-automation

1Через Skills CLI (Vercel)

npx skills add davepoon/buildwithclaude --skill googlesheets-automation -a claude-code

2Вручную: положить файлы

~/.claude/skills/googlesheets-automation/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/googlesheets-automation/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о googlesheets-automation

Как установить googlesheets-automation в Claude Code?

Выполни команду npx skills add davepoon/buildwithclaude --skill googlesheets-automation -a claude-code, затем откройте ~/.claude/skills/googlesheets-automation/SKILL.md.

Что делает googlesheets-automation?

Автоматизирует работу с Google Sheets: читает и пишет данные, управляет вкладками, форматирует ячейки, ищет и обновляет строки. Всё работает через Rube MCP и Google OAuth.

Какие требования для работы?

Нужно добавить Rube MCP как сервер (https://rube.app/mcp), подключить Google Sheets через RUBE_MANAGE_CONNECTIONS и пройти авторизацию. Диапазоны в запросах должны быть ограничены (с номерами строк), иначе может быть таймаут.

Исходный текст

SKILL.md · MIT
---
name: googlesheets-automation
description: Automate Google Sheets operations (read, write, format, filter, manage spreadsheets) via Rube MCP (Composio). Read/write data, manage tabs, apply formatting, and search rows programmatically.
requires:
  mcp: [rube]
category: business-productivity
---

# Google Sheets Automation via Rube MCP

Automate Google Sheets workflows including reading/writing data, managing spreadsheets and tabs, formatting cells, filtering rows, and upserting records through Composio's Google Sheets toolkit.

**Toolkit docs**: [composio.dev/toolkits/googlesheets](https://composio.dev/toolkits/googlesheets)

## Prerequisites

- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Google Sheets connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `googlesheets`
- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas

## Setup

**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.


1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds
2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `googlesheets`
3. If connection is not ACTIVE, follow the returned auth link to complete Google OAuth
4. Confirm connection status shows ACTIVE before running any workflows

## Core Workflows

### 1. Read and Write Data

**When to use**: User wants to read data from or write data to a Google Sheet

**Tool sequence**:
1. `GOOGLESHEETS_SEARCH_SPREADSHEETS` - Find spreadsheet by name if ID unknown [Prerequisite]
2. `GOOGLESHEETS_GET_SHEET_NAMES` - Enumerate tab names to target the right sheet [Prerequisite]
3. `GOOGLESHEETS_BATCH_GET` - Read data from one or more ranges [Required]
4. `GOOGLESHEETS_BATCH_UPDATE` - Write data to a range or append rows [Required]
5. `GOOGLESHEETS_VALUES_UPDATE` - Update a single specific range [Alternative]
6. `GOOGLESHEETS_SPREADSHEETS_VALUES_APPEND` - Append rows to end of table [Alternative]

**Key parameters**:
- `spreadsheet_id`: Alphanumeric ID from the spreadsheet URL (between '/d/' and '/edit')
- `ranges`: A1 notation array (e.g., 'Sheet1!A1:Z1000'); always use bounded ranges
- `sheet_name`: Tab name (case-insensitive matching supported)
- `values`: 2D array where each inner array is a row
- `first_cell_location`: Starting cell in A1 notation (omit to append)
- `valueInputOption`: 'USER_ENTERED' (parsed) or 'RAW' (literal)

**Pitfalls**:
- Mis-cased or non-existent tab names error "Sheet 'X' not found"
- Empty ranges may omit `valueRanges[i].values`; treat missing as empty array
- `GOOGLESHEETS_BATCH_UPDATE` values must be a 2D array (list of lists), even for a single row
- Unbounded ranges like 'A:Z' on sheets with >10,000 rows may cause timeouts; always bound with row limits
- Append follows the detected `tableRange`; use returned `updatedRange` to verify placement

### 2. Create and Manage Spreadsheets

**When to use**: User wants to create a new spreadsheet or manage tabs within one

**Tool sequence**:
1. `GOOGLESHEETS_CREATE_GOOGLE_SHEET1` - Create a new spreadsheet [Required]
2. `GOOGLESHEETS_ADD_SHEET` - Add a new tab/worksheet [Required]
3. `GOOGLESHEETS_UPDATE_SHEET_PROPERTIES` - Rename, hide, reorder, or color tabs [Optional]
4. `GOOGLESHEETS_GET_SPREADSHEET_INFO` - Get full spreadsheet metadata [Optional]
5. `GOOGLESHEETS_FIND_WORKSHEET_BY_TITLE` - Check if a specific tab exists [Optional]

**Key parameters**:
- `title`: Spreadsheet or sheet tab name
- `spreadsheetId`: Target spreadsheet ID
- `forceUnique`: Auto-append suffix if tab name exists (default true)
- `properties.gridProperties`: Set row/column counts, frozen rows

**Pitfalls**:
- Sheet names must be unique within a spreadsheet
- Default sheet names are locale-dependent ('Sheet1' in English, 'Hoja 1' in Spanish)
- Don't use `index` when creating multiple sheets in parallel (causes 'index too high' errors)
- `GOOGLESHEETS_GET_SPREADSHEET_INFO` can return 403 if account lacks access

### 3. Search and Filter Rows

**When to use**: User wants to find specific rows or apply filters to sheet data

**Tool sequence**:
1. `GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW` - Find first row matching exact cell value [Required]
2. `GOOGLESHEETS_SET_BASIC_FILTER` - Apply filter/sort to a range [Alternative]
3. `GOOGLESHEETS_CLEAR_BASIC_FILTER` - Remove existing filter [Optional]
4. `GOOGLESHEETS_BATCH_GET` - Read filtered results [Optional]

**Key parameters**:
- `query`: Exact text value to match (matches entire cell content)
- `range`: A1 notation range to search within
- `case_sensitive`: Boolean for case-sensitive matching (default false)
- `filter.range`: Grid range with sheet_id for basic filter
- `filter.criteria`: Column-based filter conditions
- `filter.sortSpecs`: Sort specifications

**Pitfalls**:
- `GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW` matches entire cell content, not substrings
- Sheet names with spaces must be single-quoted in ranges (e.g., "'My Sheet'!A:Z")
- Bare sheet names without ranges are not supported for lookup; always specify a range

### 4. Upsert Rows by Key

**When to use**: User wants to update existing rows or insert new ones based on a unique key column

**Tool sequence**:
1. `GOOGLESHEETS_UPSERT_ROWS` - Update matching rows or append new ones [Required]

**Key parameters**:
- `spreadsheetId`: Target spreadsheet ID
- `sheetName`: Tab name
- `keyColumn`: Column header name used as unique identifier (e.g., 'Email', 'SKU')
- `headers`: List of column names for the data
- `rows`: 2D array of data rows
- `strictMode`: Error on mismatched column counts (default true)

**Pitfalls**:
- `keyColumn` must be an actual header name, NOT a column letter (e.g., 'Email' not 'A')
- If `headers` is NOT provided, first row of `rows` is treated as headers
- With `strictMode=true`, rows with more values than headers cause an error
- Auto-adds missing columns to the sheet

### 5. Format Cells

**When to use**: User wants to apply formatting (bold, colors, font size) to cells

**Tool sequence**:
1. `GOOGLESHEETS_GET_SPREADSHEET_INFO` - Get numeric sheetId for target tab [Prerequisite]
2. `GOOGLESHEETS_FORMAT_CELL` - Apply formatting to a range [Required]
3. `GOOGLESHEETS_UPDATE_SHEET_PROPERTIES` - Change frozen rows, column widths [Optional]

**Key parameters**:
- `spreadsheet_id`: Spreadsheet ID
- `worksheet_id`: Numeric sheetId (NOT tab name); get from GET_SPREADSHEET_INFO
- `range`: A1 notation (e.g., 'A1:F1') - preferred over index fields
- `bold`, `italic`, `underline`, `strikethrough`: Boolean formatting options
- `red`, `green`, `blue`: Background color as 0.0-1.0 floats (NOT 0-255 ints)
- `fontSize`: Font size in points

**Pitfalls**:
- Requires numeric `worksheet_id`, not tab title; get from spreadsheet metadata
- Color channels are 0-1 floats (e.g., 1.0 for full red), NOT 0-255 integers
- Responses may return empty reply objects ([{}]); verify formatting via readback
- Format one range per call; batch formatting requires separate calls

## Common Patterns

### ID Resolution
- **Spreadsheet name -> ID**: `GOOGLESHEETS_SEARCH_SPREADSHEETS` with `query`
- **Tab name -> sheetId**: `GOOGLESHEETS_GET_SPREADSHEET_INFO`, extract from sheets metadata
- **Tab existence check**: `GOOGLESHEETS_FIND_WORKSHEET_BY_TITLE`

### Rate Limits
Google Sheets enforces strict rate limits:
- Max 60 reads/minute and 60 writes/minute
- Exceeding limits causes errors; batch operations where possible
- Use `GOOGLESHEETS_BATCH_GET` and `GOOGLESHEETS_BATCH_UPDATE` for efficiency

### Data Patterns
- Always read before writing to understand existing layout
- Use `GOOGLESHEETS_UPSERT_ROWS` for CRM syncs, inventory updates, and dedup scenarios
- Append mode (omit `first_cell_location`) is safest for adding new records
- Use `GOOGLESHEETS_CLEAR_VALUES` to clear content while preserving formatting

## Known Pitfalls

- **Tab names**: Locale-dependent defaults; 'Sheet1' may not exist in non-English accounts
- **Range notation**: Sheet names with spaces need single quotes in A1 notation
- **Unbounded ranges**: Can timeout on large sheets; always specify row bounds (e.g., 'A1:Z10000')
- **2D arrays**: All value parameters must be list-of-lists, even for single rows
- **Color values**: Floats 0.0-1.0, not integers 0-255
- **Formatting IDs**: `FORMAT_CELL` needs numeric sheetId, not tab title
- **Rate limits**: 60 reads/min and 60 writes/min; batch to stay within limits
- **Delete dimension**: `GOOGLESHEETS_DELETE_DIMENSION` is irreversible; double-check bounds

## Quick Reference

| Task | Tool Slug | Key Params |
|------|-----------|------------|
| Search spreadsheets | `GOOGLESHEETS_SEARCH_SPREADSHEETS` | `query`, `search_type` |
| Create spreadsheet | `GOOGLESHEETS_CREATE_GOOGLE_SHEET1` | `title` |
| List tabs | `GOOGLESHEETS_GET_SHEET_NAMES` | `spreadsheet_id` |
| Add tab | `GOOGLESHEETS_ADD_SHEET` | `spreadsheetId`, `title` |
| Read data | `GOOGLESHEETS_BATCH_GET` | `spreadsheet_id`, `ranges` |
| Read single range | `GOOGLESHEETS_VALUES_GET` | `spreadsheet_id`, `range` |
| Write data | `GOOGLESHEETS_BATCH_UPDATE` | `spreadsheet_id`, `sheet_name`, `values` |
| Update range | `GOOGLESHEETS_VALUES_UPDATE` | `spreadsheet_id`, `range`, `values` |
| Append rows | `GOOGLESHEETS_SPREADSHEETS_VALUES_APPEND` | `spreadsheetId`, `range`, `values` |
| Upsert rows | `GOOGLESHEETS_UPSERT_ROWS` | `spreadsheetId`, `sheetName`, `keyColumn`, `rows` |
| Lookup row | `GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW` | `spreadsheet_id`, `query` |
| Format cells | `GOOGLESHEETS_FORMAT_CELL` | `spreadsheet_id`, `worksheet_id`, `range` |
| Set filter | `GOOGLESHEETS_SET_BASIC_FILTER` | `spreadsheetId`, `filter` |
| Clear values | `GOOGLESHEETS_CLEAR_VALUES` | `spreadsheet_id`, range |
| Delete rows/cols | `GOOGLESHEETS_DELETE_DIMENSION` | `spreadsheet_id`, `sheet_name`, dimension |
| Spreadsheet info | `GOOGLESHEETS_GET_SPREADSHEET_INFO` | `spreadsheet_id` |
| Update tab props | `GOOGLESHEETS_UPDATE_SHEET_PROPERTIES` | `spreadsheetId`, properties |

---
*Powered by [Composio](https://composio.dev)*

© davepoon · MIT · davepoon/buildwithclaude

Похожие скиллы

Все скиллы по теме «Автоматизация и no-code: n8n, Zapier, Make» →
sheets-automation claude-office-skills Скилл sheets-automation для Claude Code: синхронизация данных, напоминания о задачах, отчёты и дашборды в Google Sheets. Работает, когда таблицы уже в деле. CX Codex +1 5 400установок google-sheets sanjay3290 Скилл google-sheets для чтения и записи Google Таблиц напрямую из Claude Code, Cursor, Codex и других платформ. Работает по OAuth, без MCP-сервера. CX Codex +1 483установок gws-sheets-read davila7 Команда gws-sheets-read для Claude Code, которая читает данные из Google Sheets через CLI gws. Передаёт агенту ID таблицы и диапазон — он выполняет запрос и возвращает значения. CX Codex +1 73установок mcp-gsheets freema MCP-сервер mcp-gsheets подключает Google Sheets API к агенту: читает и пишет ячейки, форматирует диапазоны, выполняет пакетные операции. CX Codex +1 ★ 105звёзд репо google-apps-script jezweb Скилл google-apps-script, который пишет скрипты Apps Script для Google Sheets и Workspace: меню, триггеры, боковые панели, выгрузка PDF. CX Codex +1 2 100установок recipe-copy-sheet-for-new-month официальный googleworkspace Скилл recipe-copy-sheet-for-new-month для Claude Code дублирует шаблонный лист Google Sheets и переименовывает его для нового месяца. Запускается агентом при работе с таблицами отслеживания или учёта. CX Codex +1 31 200установок

Из того же набора235

Весь набор →
google-drive-automation Скилл google-drive-automation автоматизирует работу с Google Drive: загружает и скачивает файлы, ищет документы, создаёт папки, делится доступом. Работает через Rube MCP и Composio — нужна активная связь с Google Drive. CX Codex +1 133установок amplitude-automation Скилл amplitude-automation подключает Amplitude к IDE через Rube MCP и Composio. Отправляйте события, ищите пользователей, управляйте когортами прямо из редактора. CX Codex +1 131установок google-analytics-automation Скилл google-analytics-automation автоматизирует выгрузку отчётов и управление ресурсами Google Analytics 4 через сервер Rube MCP. CX Codex +1 130установок activecampaign-automation Скилл activecampaign-automation управляет контактами, тегами, списками и цепочками в ActiveCampaign через Rube MCP без ручного переключения в интерфейс CRM. CX Codex +1 128установок discord-automation Скилл discord-automation автоматизирует отправку сообщений, управление ролями, вебхуками и реакциями в Discord через Rube MCP и Composio. Помогает ботам работать с каналами и пользователями прямо из агента. CX Codex +1 128установок twitter-automation Скилл twitter-automation для Claude Code, Cursor, Codex и других агентов, который подключает Twitter/X через Rube MCP (Composio): посты, поиск, закладки, списки, медиа. CX Codex +1 128установок salesforce-automation Скилл salesforce-automation для Claude Code автоматизирует работу с Salesforce через Composio. Создаёт и ищет лиды, контакты, аккаунты и сделки, выполняет SOQL-запросы. CX Codex +1 128установок slack-automation Скилл slack-automation автоматизирует отправку сообщений, поиск по переписке, треды и реакции в Slack через Rube MCP от Composio. CX Codex +1 128установок

Ещё в каталоге

Спонсоры проекта

Компании, которые помогают держать аналитику открытой