mcp-gsheets — MCP-сервер для Claude Code: работа с Google Sheets
Подключает Google Sheets API к агенту: читает и пишет ячейки, форматирует диапазоны, выполняет пакетные операции.
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Что делает mcp-gsheets
Сервер даёт агенту прямой доступ к таблицам Google Sheets. Можно читать данные из диапазонов, записывать значения, применять форматирование и условное форматирование, работать с диаграммами. Пакетные операции позволяют обновить сотни строк одним запросом.
Для запуска нужен Node.js 22 или выше и сервисный аккаунт Google Cloud с включённым Sheets API. Поддерживаются три способа аутентификации: файл JSON с ключом, строка JSON целиком или пара приватный ключ + email. Таблицы, с которыми работает агент, нужно расшарить на email сервисного аккаунта с правами редактора — без этого сервер не получит доступ.
Сервер собран на TypeScript, есть обработка ошибок и покрытие тестами.
Какие задачи решает
- Читать данные из диапазонов ячеек
- Записывать и обновлять значения пакетно
- Применять форматирование и условные правила
- Создавать диаграммы в таблицах
- Получать метаданные листов и книг
Примеры запросов агенту
- Прочитай диапазон A1:D50 из таблицы с идентификатором 1a2b3c4d5e
- Запиши эти строки в лист
Продажи, начиная с ячейки B2 - Отформатируй столбец C как валюту с двумя знаками после запятой
Как установить mcp-gsheets
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-gsheets
Как установить mcp-gsheets в Claude Code?
Выполни команду `claude mcp add mcp-gsheets -e GOOGLE_PROJECT_ID=<GOOGLE_PROJECT_ID> -e GOOGLE_SERVICE_ACCOUNT_KEY=<GOOGLE_SERVICE_ACCOUNT_KEY> -e GOOGLE_PRIVATE_KEY=<GOOGLE_PRIVATE_KEY> -- npx -y mcp-gsheets`, подставив свои значения переменных окружения.
Что делает mcp-gsheets?
Интегрирует Google Sheets API в агента: позволяет читать, записывать и форматировать ячейки, выполнять пакетные обновления, работать с диаграммами и условным форматированием.
Какие данные нужны для подключения?
Нужен проект в Google Cloud с включённым Sheets API и сервисный аккаунт. Можно передать путь к JSON-ключу через GOOGLE_APPLICATION_CREDENTIALS, либо JSON целиком в GOOGLE_SERVICE_ACCOUNT_KEY, либо только приватный ключ и email через GOOGLE_PRIVATE_KEY и GOOGLE_CLIENT_EMAIL.
