Google Sheets·xing5

Google Sheets MCP — подключение и инструкция

Google Sheets MCP подключает агента к таблицам Google: чтению листов, диапазонов и разрешённым изменениям ячеек.

Файлы и документыЛокальноAPI-ключ

Что умеет этот сервер

01

Google Sheets MCP подключает агента к таблицам Google: чтению листов, диапазонов и разрешённым изменениям ячеек.

02

Community-сервер xing5 поддерживает несколько способов Google Cloud credentials.

03

Прочитай список листов одной тестовой таблицы, затем небольшой 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 должен получить доступ к нужной таблице.
  1. 01

    Подготовь окружение

    uv/uvx, включённые Google Sheets API и Google Drive API, выбранные credentials. Service Account должен получить доступ к нужной таблице.

  2. 02

    Установи и настрой

    Добавь uvx mcp-google-sheets@latest. Настрой SERVICE_ACCOUNT_PATH либо другой поддерживаемый способ авторизации по GCP Setup. При необходимости ограничь include-tools нужными операциями, не меняя чужие подключения.

  3. 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-серверов Нейролюба.

Вопросы о Google Sheets

Google Sheets MCP подключает агента к таблицам Google: чтению листов, диапазонов и разрешённым изменениям ячеек.
Вернуться в библиотеку