Google Sheets MCP в Claude Code: подключение таблиц

MCP: Google Sheets в Claude Code

Google Sheets MCP даёт Claude Code доступ к вашим Google таблицам: создавать новые, читать данные, редактировать ячейки, искать по содержимому. Claude сможет работать с таблицами по вашей просьбе — например: «Создай таблицу для учёта расходов» или «Покажи данные из моей таблицы бюджета».

Требуется: Claude Code (macOS
| Windows)

---

1. Установите uv

macOS / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

После установки перезапустите терминал.

Проверьте установку:

uvx --version

Если видите версию — всё готово.

---

2. Создайте проект в Google Cloud Console

1. Откройте в браузере: console.cloud.google.com
2. Войдите в свой Google аккаунт
3. При первом входе система попросит создать аккаунт и выбрать

страну. России нет в списке — выберите любую другую (например, Армения, Казахстан или Грузия). Это влияет только на валюту биллинга, для бесплатного использования API не имеет значения. После чего нажмите → Agree and continue

1. В верхней панели нажмите на выпадающий список проектов →

New Project (Новый проект)

Создание нового проекта

New project

1. Введите название проекта (например, claude-sheets) и

нажмите Create.

1. Дождитесь создания и убедитесь, что новый проект выбран в верхней

панели

Проект создан

---

3. Включите необходимые API

1. В боковом меню выберите APIs & Services →

Library

APIs & Services → Library

1. В поиске введите Google Sheets API → откройте его →

нажмите Enable

Google Sheets API

Enable Google Sheets API

1. Вернитесь в Library, найдите по такому же принципу

Google Drive API → нажмите Enable

---

4. Настройте OAuth Consent Screen

1. В боковом меню выберите APIs & Services →

OAuth consent screen

1. Нажмите Get Started

Get Started

1. Заполните обязательные поля:

App name — любое название (например, Claude Sheets)

1. User support email — ваш email
2. Нажмите Next.
3. Выберите External (внешний) и нажмите

Next.

1. Заполните обязательные поля:

Email adresses — ваш email

1. Нажмите Next.
2. Согласитесь с условиями на последнем шаге и нажмите

Create.

1. Перейдите в Audience → пролистните до

Test users и нажмите Add users. В появившемся окошке напишите email, который указывали ранее.

Test users

---

5. Создайте OAuth credentials

1. В боковом меню выберите APIs & Services →

Credentials

1. Нажмите + Create Credentials → **OAuth

client ID**

Create Credentials

1. Выберите Application type:

Desktop app. Введите название (например, Claude Desktop)

Desktop app

1. Нажмите Create
2. В появившемся окне нажмите Download JSON

Download JSON

1. Скачанный файл переименуйте в

credentials.json

---

6. Разместите credentials

Создайте папку и переместите туда файл:

macOS / Linux:

Создайте папку для хранения credentials:

mkdir -p ~/.claude/google-sheets

Переместите скачанный файл в эту папку:

mv ~/Downloads/credentials.json ~/.claude/google-sheets/

Windows (PowerShell):

Создайте папку для хранения credentials:

mkdir -Force "$env:USERPROFILE\.claude\google-sheets"

Переместите скачанный файл в эту папку:

Move-Item "$env:USERPROFILE\Downloads\credentials.json" "$env:USERPROFILE\.claude\google-sheets\"

---

7. Авторизуйте Google Sheets MCP

Запустите команду для первичной авторизации:

macOS / Linux:

CREDENTIALS_PATH=~/.claude/google-sheets/credentials.json \
TOKEN_PATH=~/.claude/google-sheets/token.json \
uvx mcp-google-sheets@latest

Windows (PowerShell):

Укажите путь к credentials:

$env:CREDENTIALS_PATH="$env:USERPROFILE\.claude\google-sheets\credentials.json"

Укажите путь, куда сохранится токен:

$env:TOKEN_PATH="$env:USERPROFILE\.claude\google-sheets\token.json"

Запустите MCP для авторизации:

uvx mcp-google-sheets@latest

Откроется браузер с авторизацией Google:

1. Выберите свой Google аккаунт (тот, что добавлен в Test users)
2. Появится предупреждение «Google hasn’t verified this app» — нажмите

Continue

1. Разрешите доступ к Google Sheets и Drive
2. После успешной авторизации вернитесь в терминал и нажмите

Ctrl+C

В папке ~/.claude/google-sheets/ появится файл token.json — это подтверждение успешной авторизации.

---

8. Добавьте Google Sheets MCP в Claude Code

macOS / Linux:

claude mcp add google-sheets \
  -e CREDENTIALS_PATH=$HOME/.claude/google-sheets/credentials.json \
  -e TOKEN_PATH=$HOME/.claude/google-sheets/token.json \
  -- uvx mcp-google-sheets@latest

Windows (PowerShell):

claude mcp add google-sheets `
  -e CREDENTIALS_PATH="$env:USERPROFILE\.claude\google-sheets\credentials.json" `
  -e TOKEN_PATH="$env:USERPROFILE\.claude\google-sheets\token.json" `
  -- uvx mcp-google-sheets@latest

---

9. Проверьте работу

claude

Спросите:

Создай новую Google таблицу с названием "Тест Claude"

Если Claude создаёт таблицу и показывает ссылку — всё работает!

---

Что можно делать с Google Sheets MCP

Создание таблиц:

Создай таблицу для учёта расходов с колонками: дата, категория, сумма, описание

Сделай таблицу для трекинга задач с колонками: задача, приоритет, статус, дедлайн

Чтение данных:

Покажи содержимое моей таблицы "Бюджет 2025"

Какие данные в ячейках A1:D10 в таблице [ID таблицы]?

Редактирование:

Добавь новую строку в таблицу расходов: сегодня, продукты, 2500, Пятёрочка

Обнови ячейку B5 в таблице "Задачи" на "Выполнено"

Анализ:

Найди все ячейки со словом "срочно" в моих таблицах

Покажи сводку по всем моим таблицам в Google Drive

---

Доступные инструменты

• Инструмент: list_spreadsheets; Что делает: Список ваших таблиц
• Инструмент: create_spreadsheet; Что делает: Создание новой таблицы
• Инструмент: get_sheet_data; Что делает: Чтение данных из диапазона ячеек
• Инструмент: update_cells; Что делает: Запись данных в ячейки
• Инструмент: list_sheets; Что делает: Список листов в таблице
• Инструмент: add_rows; Что делает: Добавление строк
• Инструмент: add_columns; Что делает: Добавление колонок
• Инструмент: create_sheet; Что делает: Создание нового листа
• Инструмент: copy_sheet; Что делает: Копирование листа
• Инструмент: rename_sheet; Что делает: Переименование листа
• Инструмент: share_spreadsheet; Что делает: Предоставление доступа
• Инструмент: find_in_spreadsheet; Что делает: Поиск по содержимому
• Инструмент: get_sheet_formulas; Что делает: Просмотр формул

---

Проверка установки

claude mcp list

В списке должен быть google-sheets.

---

Частые проблемы

«claude: command not found»

Claude Code не установлен. Пройдите гайд по установке (macOS | Windows).

«uvx: command not found»

uv не установлен. Выполните команду установки из шага 1 и перезапустите терминал.

Браузер не открывается при авторизации

• Проверьте, что credentials.json находится по

правильному пути

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

появится

«Access blocked: This app’s request is invalid»

• Убедитесь, что ваш email добавлен в Test users в

Google Cloud Console

• Проверьте, что OAuth consent screen настроен правильно (шаг 4)

«Error 403: access_denied»

• Добавьте свой Gmail в Test users (Google Cloud Console → OAuth

consent screen → Test users)

• Используйте тот же аккаунт, что указан в Test users

«File not found: credentials.json»

Проверьте путь к файлу:

macOS / Linux:

ls ~/.claude/google-sheets/credentials.json

Windows:

dir "$env:USERPROFILE\.claude\google-sheets\credentials.json"

MCP добавился, но Claude не видит таблицы

• Перезапустите Claude Code
• Уточните запрос: явно упомяните «Google Sheets» или «Google

таблицу»

• Проверьте, что авторизация прошла успешно (есть файл

token.json)

«Token has been expired or revoked»

Удалите старый токен и авторизуйтесь заново:

macOS / Linux:

rm ~/.claude/google-sheets/token.json

Затем повторите шаг 7.

---

Безопасность

• credentials.json — это ключ к вашему приложению в

Google Cloud. Не публикуйте его

• token.json — токен доступа к вашему Google

аккаунту. Хранится локально

• Отозвать доступ можно в любой момент: myaccount.google.com/permissions
• Credentials и токены хранятся только на вашем компьютере, не

передаются никуда

---

Готово!

Теперь в Claude Code доступны:

• Создание таблиц — новые таблицы с нужной

структурой

• Чтение данных — просмотр содержимого любых ваших

таблиц

• Редактирование — обновление ячеек, добавление строк

и колонок

• Поиск — поиск по содержимому таблиц
• Управление — копирование, переименование,

предоставление доступа

Официальный репозиторий: xing5/mcp-google-sheets