# mcp-gsheets

Подключает Google Sheets API к агенту: читает и пишет ячейки, форматирует диапазоны, выполняет пакетные операции.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 104
- Автор: freema
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/freema/mcp-gsheets
- Обновлён: 2026-10-04
- HTML: https://affpapa.org/nevibecode/mcp/mcp-gsheets

## Что делает

Сервер даёт агенту прямой доступ к таблицам Google Sheets. Можно читать данные из диапазонов, записывать значения, применять форматирование и условное форматирование, работать с диаграммами. Пакетные операции позволяют обновить сотни строк одним запросом.

Для запуска нужен Node.js 22 или выше и сервисный аккаунт Google Cloud с включённым Sheets API. Поддерживаются три способа аутентификации: файл JSON с ключом, строка JSON целиком или пара приватный ключ + email. Таблицы, с которыми работает агент, нужно расшарить на email сервисного аккаунта с правами редактора — без этого сервер не получит доступ.

Сервер собран на TypeScript, есть обработка ошибок и покрытие тестами.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `GOOGLE_PROJECT_ID`, `GOOGLE_APPLICATION_CREDENTIALS`, `GOOGLE_SERVICE_ACCOUNT_KEY`, `GOOGLE_PRIVATE_KEY`, `GOOGLE_CLIENT_EMAIL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.
- Работает с: Google Workspace

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env GOOGLE_PROJECT_ID=<GOOGLE_PROJECT_ID> --env GOOGLE_APPLICATION_CREDENTIALS=<GOOGLE_APPLICATION_CREDENTIALS> --env GOOGLE_SERVICE_ACCOUNT_KEY=<GOOGLE_SERVICE_ACCOUNT_KEY> --env GOOGLE_PRIVATE_KEY=<GOOGLE_PRIVATE_KEY> --env GOOGLE_CLIENT_EMAIL=<GOOGLE_CLIENT_EMAIL> --transport stdio mcp-gsheets -- npx -y mcp-gsheets
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add mcp-gsheets --env GOOGLE_PROJECT_ID=<GOOGLE_PROJECT_ID> --env GOOGLE_APPLICATION_CREDENTIALS=<GOOGLE_APPLICATION_CREDENTIALS> --env GOOGLE_SERVICE_ACCOUNT_KEY=<GOOGLE_SERVICE_ACCOUNT_KEY> --env GOOGLE_PRIVATE_KEY=<GOOGLE_PRIVATE_KEY> --env GOOGLE_CLIENT_EMAIL=<GOOGLE_CLIENT_EMAIL> -- npx -y mcp-gsheets
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-gsheets": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-gsheets"
            ],
            "env": {
                "GOOGLE_PROJECT_ID": "<GOOGLE_PROJECT_ID>",
                "GOOGLE_APPLICATION_CREDENTIALS": "<GOOGLE_APPLICATION_CREDENTIALS>",
                "GOOGLE_SERVICE_ACCOUNT_KEY": "<GOOGLE_SERVICE_ACCOUNT_KEY>",
                "GOOGLE_PRIVATE_KEY": "<GOOGLE_PRIVATE_KEY>",
                "GOOGLE_CLIENT_EMAIL": "<GOOGLE_CLIENT_EMAIL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-gsheets": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mcp-gsheets"
            ],
            "env": {
                "GOOGLE_PROJECT_ID": "<GOOGLE_PROJECT_ID>",
                "GOOGLE_APPLICATION_CREDENTIALS": "<GOOGLE_APPLICATION_CREDENTIALS>",
                "GOOGLE_SERVICE_ACCOUNT_KEY": "<GOOGLE_SERVICE_ACCOUNT_KEY>",
                "GOOGLE_PRIVATE_KEY": "<GOOGLE_PRIVATE_KEY>",
                "GOOGLE_CLIENT_EMAIL": "<GOOGLE_CLIENT_EMAIL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e GOOGLE_PROJECT_ID=<GOOGLE_PROJECT_ID> -e GOOGLE_APPLICATION_CREDENTIALS=<GOOGLE_APPLICATION_CREDENTIALS> -e GOOGLE_SERVICE_ACCOUNT_KEY=<GOOGLE_SERVICE_ACCOUNT_KEY> -e GOOGLE_PRIVATE_KEY=<GOOGLE_PRIVATE_KEY> -e GOOGLE_CLIENT_EMAIL=<GOOGLE_CLIENT_EMAIL> mcp-gsheets npx -y mcp-gsheets
```
Вместо <…> подставьте свои значения

## Когда брать
- Читать данные из диапазонов ячеек
- Записывать и обновлять значения пакетно
- Применять форматирование и условные правила
- Создавать диаграммы в таблицах
- Получать метаданные листов и книг

## Примеры запросов агенту
- Прочитай диапазон A1:D50 из таблицы с идентификатором 1a2b3c4d5e
- Запиши эти строки в лист `Продажи`, начиная с ячейки B2
- Отформатируй столбец C как валюту с двумя знаками после запятой

## Похожие
- [Excel MCP Server](https://affpapa.org/nevibecode/mcp/excel-mcp-server.md) — MCP-сервер · ★ 4259
- [kordoc](https://affpapa.org/nevibecode/mcp/kordoc.md) — MCP-сервер · ★ 2726
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP-сервер · ★ 1247
- [Microsoft 365 MCP Server](https://affpapa.org/nevibecode/mcp/microsoft-365-mcp-server.md) — MCP-сервер · ★ 1074
- [anymd](https://affpapa.org/nevibecode/mcp/anymd.md) — MCP-сервер · ★ 1051
- [Docling MCP](https://affpapa.org/nevibecode/mcp/docling-mcp.md) — MCP-сервер · ★ 777

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md