Google Sheets·xing5
Google Sheets MCP — подключение и инструкция
Google Sheets MCP подключает агента к таблицам Google: чтению листов, диапазонов и разрешённым изменениям ячеек.
Что умеет этот сервер
Google Sheets MCP подключает агента к таблицам Google: чтению листов, диапазонов и разрешённым изменениям ячеек.
Community-сервер xing5 поддерживает несколько способов Google Cloud credentials.
Прочитай список листов одной тестовой таблицы, затем небольшой A1-range.
Задача для знакомства
Через Google Sheets MCP прочитай выбранный диапазон тестового листа и покажи значения и формулы отдельно. Ячейки не меняй.
Уточнить результат
Сверь spreadsheet ID и sheet ID — это разные идентификаторы. Проверь границы диапазона, даты и формулы в интерфейсе; формат отображения не равен сохранённому значению.
Как подключить
Выберите подходящий способПодключить Google Sheets MCP
Добавь uvx mcp-google-sheets@latest. Настрой SERVICE_ACCOUNT_PATH либо другой поддерживаемый способ авторизации по GCP Setup. При необходимости ограничь include-tools нужными операциями, не меняя чужие подключения.
Что понадобится
- uv/uvx, включённые Google Sheets API и Google Drive API, выбранные credentials. Service Account должен получить доступ к нужной таблице.
- 01
Подготовь окружение
uv/uvx, включённые Google Sheets API и Google Drive API, выбранные credentials. Service Account должен получить доступ к нужной таблице.
- 02
Установи и настрой
Добавь uvx mcp-google-sheets@latest. Настрой SERVICE_ACCOUNT_PATH либо другой поддерживаемый способ авторизации по GCP Setup. При необходимости ограничь include-tools нужными операциями, не меняя чужие подключения.
- 03
Открой новую сессию
Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.
Пример MCP-конфигурации на основе README
{
"mcpServers": {
"google-sheets": {
"command": "uvx",
"args": [
"mcp-google-sheets@latest",
"--include-tools",
"get_sheet_data,update_cells,list_spreadsheets,list_sheets"
],
"env": {
"SERVICE_ACCOUNT_PATH": "/path/to/credentials.json"
}
}
}
}Первый запрос — пример для чата агента
Через Google Sheets MCP прочитай выбранный диапазон тестового листа и покажи значения и формулы отдельно. Ячейки не меняй.Как проверить
Сверь spreadsheet ID и sheet ID — это разные идентификаторы. Проверь границы диапазона, даты и формулы в интерфейсе; формат отображения не равен сохранённому значению.
Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.
README и установка автораЧто умеет Google Sheets
Google Sheets MCP подключает агента к таблицам Google: чтению листов, диапазонов и разрешённым изменениям ячеек.
Community-сервер xing5 поддерживает несколько способов Google Cloud credentials. Service Account и пользовательский OAuth дают разные области доступа; доступ к файлу определяется также его sharing-настройками.
Что подготовить перед подключением
uv/uvx, включённые Google Sheets API и Google Drive API, выбранные credentials. Service Account должен получить доступ к нужной таблице.
Как установить и подключить
Добавь uvx mcp-google-sheets@latest. Настрой SERVICE_ACCOUNT_PATH либо другой поддерживаемый способ авторизации по GCP Setup. При необходимости ограничь include-tools нужными операциями, не меняя чужие подключения.
Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.
Как пользоваться: первый сценарий
Прочитай список листов одной тестовой таблицы, затем небольшой A1-range. Для записи укажи точный spreadsheet ID, имя листа, диапазон и типы значений.
Как проверить результат и решить проблемы
Сверь spreadsheet ID и sheet ID — это разные идентификаторы. Проверь границы диапазона, даты и формулы в интерфейсе; формат отображения не равен сохранённому значению.
Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.
Ограничения
Google Cloud credentials не открывают автоматически все документы. Лимиты API и права sharing действуют независимо; массовая запись требует сохранения соседних ячеек.
Исходники и документация
Репозиторий: xing5/mcp-google-sheets. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.
Другие подключения — в каталоге MCP-серверов Нейролюба.