Google Таблицы MCP

xing5/mcp-google-sheets· Проверено 12.11.2026· 1 тыс.на GitHub

Подключает агента к Google Таблицам через API: найти и создать таблицу, прочитать и записать диапазон, добавить лист, строки и диаграмму, открыть доступ коллегам.

2 реализации:

Отдельный сервер только для Таблиц и Диска на Python, ставится через uvx; входит через сервисный аккаунт, OAuth или учётные данные gcloud, строит диаграммы.

Как подключить

Что сделать до подключения

uv с командой uvx

Проект в Google Cloud Console с включёнными Google Sheets API и Google Drive API

Папка на Google Диске, открытая сервисному аккаунту с правами редактора

SERVICE_ACCOUNT_PATH

Google Cloud Console → IAM & Admin → Service Accounts → создать аккаунт → Manage keys → ADD KEY → JSON

DRIVE_FOLDER_ID

ID папки из адреса drive.google.com/drive/folders/<ID>; папку откройте на адрес client_email из ключа

CREDENTIALS_PATH

вместо сервисного аккаунта: JSON OAuth-клиента типа Desktop app, токен ляжет в TOKEN_PATH

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'SERVICE_ACCOUNT_PATH=<полный путь к JSON-ключу сервисного аккаунта>' --env 'DRIVE_FOLDER_ID=<ID папки на Google Диске>' --transport stdio google-sheets \
  -- uvx mcp-google-sheets@latest

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.google-sheets]
command = "uvx"
args = ["mcp-google-sheets@latest"]

[mcp_servers.google-sheets.env]
SERVICE_ACCOUNT_PATH = "<полный путь к JSON-ключу сервисного аккаунта>"
DRIVE_FOLDER_ID = "<ID папки на Google Диске>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "google-sheets": {
      "command": "uvx",
      "args": ["mcp-google-sheets@latest"],
      "env": {
        "SERVICE_ACCOUNT_PATH": "<полный путь к JSON-ключу сервисного аккаунта>",
        "DRIVE_FOLDER_ID": "<ID папки на Google Диске>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "google-sheets": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-google-sheets@latest"],
      "env": {
        "SERVICE_ACCOUNT_PATH": "<полный путь к JSON-ключу сервисного аккаунта>",
        "DRIVE_FOLDER_ID": "<ID папки на Google Диске>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "google-sheets": {
      "command": "uvx",
      "args": ["mcp-google-sheets@latest"],
      "env": {
        "SERVICE_ACCOUNT_PATH": "<полный путь к JSON-ключу сервисного аккаунта>",
        "DRIVE_FOLDER_ID": "<ID папки на Google Диске>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "google-sheets": {
      "command": "uvx",
      "args": ["mcp-google-sheets@latest"],
      "env": {
        "SERVICE_ACCOUNT_PATH": "<полный путь к JSON-ключу сервисного аккаунта>",
        "DRIVE_FOLDER_ID": "<ID папки на Google Диске>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "google-sheets": {
        "type": "local",
        "command": ["uvx", "mcp-google-sheets@latest"],
        "environment": {
          "SERVICE_ACCOUNT_PATH": "<полный путь к JSON-ключу сервисного аккаунта>",
          "DRIVE_FOLDER_ID": "<ID папки на Google Диске>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "google-sheets": {
      "command": "uvx",
      "args": ["mcp-google-sheets@latest"],
      "env": {
        "SERVICE_ACCOUNT_PATH": "<полный путь к JSON-ключу сервисного аккаунта>",
        "DRIVE_FOLDER_ID": "<ID папки на Google Диске>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "google-sheets": {
      "command": "uvx",
      "args": ["mcp-google-sheets@latest"],
      "env": {
        "SERVICE_ACCOUNT_PATH": "<полный путь к JSON-ключу сервисного аккаунта>",
        "DRIVE_FOLDER_ID": "<ID папки на Google Диске>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

list_spreadsheetsперечисляет таблицы

search_spreadsheetsищет таблицы

create_spreadsheetсоздаёт таблицу

get_sheet_dataчитает диапазон

get_sheet_formulasчитает формулы

update_cellsзаписывает диапазон

batch_update_cellsзаписывает несколько диапазонов

add_rowsвставляет пустые строки

add_columnsвставляет пустые столбцы

list_sheetsперечисляет листы

create_sheetдобавляет лист

copy_sheetкопирует лист в другую таблицу

rename_sheetпереименовывает лист

get_multiple_sheet_dataчитает диапазоны из разных таблиц

get_multiple_spreadsheet_summaryпоказывает заголовки и первые строки

find_in_spreadsheetищет значение в таблице

share_spreadsheetоткрывает доступ к таблице

list_foldersперечисляет папки Диска

add_chartстроит диаграмму

Показано 19 из 20.

Большой сервер для всего Google Workspace, здесь — его часть про Таблицы: форматирование, условное форматирование, структурированные таблицы, именованные диапазоны и комментарии; вход через ваш OAuth-клиент.

Как подключить

Что сделать до подключения

uv с командой uvx; Python 3.10 или новее

Проект в Google Cloud Console с включённым API Таблиц и OAuth-клиентом

GOOGLE_OAUTH_CLIENT_ID

Google Cloud Console → ваш проект → OAuth-клиент

GOOGLE_OAUTH_CLIENT_SECRET

секрет того же OAuth-клиента

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'GOOGLE_OAUTH_CLIENT_ID=<OAuth Client ID>' --env 'GOOGLE_OAUTH_CLIENT_SECRET=<OAuth Client Secret>' --transport stdio google-workspace-mcp \
  -- uvx workspace-mcp --tools sheets

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.google-workspace-mcp]
command = "uvx"
args = ["workspace-mcp", "--tools", "sheets"]

[mcp_servers.google-workspace-mcp.env]
GOOGLE_OAUTH_CLIENT_ID = "<OAuth Client ID>"
GOOGLE_OAUTH_CLIENT_SECRET = "<OAuth Client Secret>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": ["workspace-mcp", "--tools", "sheets"],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "<OAuth Client ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<OAuth Client Secret>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "google-workspace-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["workspace-mcp", "--tools", "sheets"],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "<OAuth Client ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<OAuth Client Secret>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": ["workspace-mcp", "--tools", "sheets"],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "<OAuth Client ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<OAuth Client Secret>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": ["workspace-mcp", "--tools", "sheets"],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "<OAuth Client ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<OAuth Client Secret>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "google-workspace-mcp": {
        "type": "local",
        "command": ["uvx", "workspace-mcp", "--tools", "sheets"],
        "environment": {
          "GOOGLE_OAUTH_CLIENT_ID": "<OAuth Client ID>",
          "GOOGLE_OAUTH_CLIENT_SECRET": "<OAuth Client Secret>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": ["workspace-mcp", "--tools", "sheets"],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "<OAuth Client ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<OAuth Client Secret>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": ["workspace-mcp", "--tools", "sheets"],
      "env": {
        "GOOGLE_OAUTH_CLIENT_ID": "<OAuth Client ID>",
        "GOOGLE_OAUTH_CLIENT_SECRET": "<OAuth Client Secret>"
      }
    }
  }
}

Инструменты сервера

list_spreadsheetsперечисляет доступные таблицы

get_spreadsheet_infoпоказывает листы таблицы

create_spreadsheetсоздаёт таблицу

read_sheet_valuesчитает диапазон

modify_sheet_valuesзаписывает или очищает диапазон

create_sheetдобавляет или дублирует лист

manage_sheet_tabпереименовывает, скрывает, удаляет лист

format_sheet_rangeформатирует диапазон

manage_conditional_formattingнастраивает условное форматирование

list_sheet_tablesперечисляет структурированные таблицы

append_table_rowsдописывает строки в таблицу

resize_sheet_dimensionsменяет ширину столбцов и высоту строк

move_sheet_rowsпереносит строки на другой лист

manage_named_rangeуправляет именованными диапазонами

manage_spreadsheet_commentработает с комментариями

Показано 15 из 16.

Что попросить агента

«Покажи все таблицы, к которым у меня есть доступ»Агент вызовет list_spreadsheets

«Создай таблицу «<название>»»Агент вызовет create_spreadsheet

«В таблице «<название>» возьми данные с листа Sheet1 из диапазона A1:E10»Агент вызовет get_sheet_data, в Google Workspace MCP — read_sheet_values

«Открой таблицу «<название>» для <адрес> на чтение и для <адрес> на редактирование, без уведомлений»Агент вызовет share_spreadsheet

«Построй столбчатую диаграмму помесячной выручки по диапазону A1:B13 в таблице «<название>»»Агент вызовет add_chart с типом COLUMN

Для каких задач

Создать таблицу и заполнить её данными

Прочитать диапазон или сводку по нескольким таблицам сразу

Обновить ячейки и дописать строки в журнал

Построить столбчатую, круговую или линейную диаграмму по диапазону

Открыть таблицу коллегам на чтение или редактирование без уведомлений

Раскрасить диапазон и настроить условное форматирование

Ограничения

Нужен проект в Google Cloud Console с включёнными API и учётные данные: сервисный аккаунт, OAuth-клиент или вход через gcloud

Сервисный аккаунт видит только папки и таблицы, открытые на его адрес client_email

Все инструменты mcp-google-sheets занимают около 13 000 токенов контекста до начала разговора; лишние отключаются через --include-tools или ENABLED_TOOLS

update_cells записывает поверх данных, которые уже стоят в диапазоне

Если не работает

На macOS клиент пишет spawn uvx ENOENT

Укажите в command полный путь: /Users/<имя пользователя>/.local/bin/uvx.

uvx запускает старую версию mcp-google-sheets

Без @latest uvx берёт закэшированную версию. Пишите в args mcp-google-sheets@latest.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
mcp-google-sheets	xing5	1 тыс.	локально	токен	20	14 мая 2026
Google Workspace MCP Server	taylorwilsdon	3,5 тыс.	локально	вход	16	11 ноября 2026

Частые вопросы

Сервисный аккаунт или OAuth?

Сервисный аккаунт работает без браузера и рекомендован для mcp-google-sheets: создайте ключ JSON и откройте папку на его адрес с правами редактора. OAuth подходит для личного использования: при первом запуске откроется окно входа Google, файл TOKEN_PATH должен быть доступен на запись.

Где взять ID таблицы и папки?

Из адреса: в docs.google.com/spreadsheets/d/<ID>/edit это ID таблицы, в drive.google.com/drive/folders/<ID> — ID папки.

Какие диаграммы умеет строить агент?

add_chart в mcp-google-sheets строит COLUMN, BAR, LINE, AREA, PIE, SCATTER, COMBO и HISTOGRAM; первая строка диапазона считается заголовками.

Как уменьшить число инструментов?

В mcp-google-sheets перечислите нужные в --include-tools, например get_sheet_data,update_cells,list_spreadsheets,list_sheets. В Google Workspace MCP флаг --tools sheets оставляет только Таблицы, а --tool-tier core — три основных инструмента.

Можно запустить mcp-google-sheets в Docker?

Да, образ из Dockerfile работает по SSE на порту 8000. Учётные данные в контейнер удобнее передать строкой Base64 в CREDENTIALS_CONFIG вместе с DRIVE_FOLDER_ID.

Работает ли сервер из России?

Оба сервера запускаются на вашем компьютере и ходят в API Google по вашим учётным данным; нужен аккаунт Google и проект в Google Cloud Console.

Google Таблицы MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы