google-sheets-mcp — MCP-сервер для Claude Code: CRUD в Google Sheets
MCP-сервер, через который агент создаёт, читает, обновляет и удаляет листы и таблицы Google Sheets. Работает по ключу сервисного аккаунта.
claude mcp add google-sheets-mcp -- uvx google-sheets-mcpЧто делает google-sheets-mcp
Сервер даёт агенту набор инструментов для полного CRUD в Google Sheets: создать таблицу, прочитать диапазон, переписать ячейки, удалить лист. Авторизация идёт через сервисный аккаунт Google Cloud, а сам пакет ставится через uvx и запускается по требованию клиента.
Подготовить нужно три вещи. Первая — проект в Google Cloud с включёнными Sheets API и Drive API. Вторая — сервисный аккаунт с JSON-ключом: значения project_id, private_key, client_email и остальные поля переносятся в блок env конфигурации MCP как есть. Третья — доступ: таблицу придётся расшарить на адрес сервисного аккаунта с правами Editor, иначе запросы упрутся в отказ.
Нужен Python 3.10+ и менеджер пакетов uv. По конфигурации: клиент ищет переменные с теми же именами, что в JSON-ключе, а старые варианты с префиксом GOOGLE_ тоже принимаются — пригодятся, если настройка уже лежит в конфиге с прошлого раза. Ключ содержит приватную часть, поэтому файл и блок env не стоит коммитить в репозиторий.
Какие задачи решает
- Создать новую таблицу и написать в неё заголовки
- Прочитать диапазон ячеек и отдать данные агенту
- Обновить строки в существующем листе по просьбе из чата
- Удалить лист или таблицу, которая больше не нужна
- Расшарить сервисный аккаунт на таблицу и работать с ней из агента
Примеры запросов агенту
- Создай таблицу и запиши в первый лист список задач из
tasks.md - Прочитай диапазон
A1:D20из таблицы и покажи, какие строки пустые - Добавь в лист
Отчётстроку с итогами за неделю
Как установить google-sheets-mcp
Командой платформы
claude mcp add google-sheets-mcp -- uvx google-sheets-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from google-sheets-mcp <команда>
Командой платформы
codex mcp add google-sheets-mcp -- uvx google-sheets-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from google-sheets-mcp <команда>
Файл настроек
{
"mcpServers": {
"google-sheets-mcp": {
"command": "uvx",
"args": [
"google-sheets-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from google-sheets-mcp <команда>
Файл настроек
{
"servers": {
"google-sheets-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"google-sheets-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from google-sheets-mcp <команда>
Командой платформы
gemini mcp add google-sheets-mcp uvx google-sheets-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from google-sheets-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о google-sheets-mcp
Как установить google-sheets-mcp в Claude Code?
Выполните claude mcp add google-sheets-mcp -- uvx google-sheets-mcp, затем добавьте значения из JSON-ключа сервисного аккаунта в переменные окружения сервера.
Что делает google-sheets-mcp?
Даёт MCP-клиенту инструменты для создания, чтения, обновления и удаления листов и таблиц Google Sheets через API.
Что нужно подготовить до запуска?
Проект Google Cloud с включёнными Google Sheets API и Google Drive API, сервисный аккаунт с JSON-ключом, Python 3.10+ и uv. Таблицу нужно расшарить на email сервисного аккаунта с правами Editor.
