README.md
MCP server for interacting with Google Sheets, Google Docs, and Google Drive.
-+693# Google Sheets MCP Server
MCP (Model Context Protocol) сервер для взаимодействия с Google Sheets, Google Docs и Google Drive.
Возможности
Google Sheets
- Чтение данных из таблиц
- Обновление ячеек
- Пакетное обновление нескольких диапазонов
- Добавление строк и столбцов
- Создание, переименование, копирование и удаление листов
- Получение формул из ячелей
- Получение списка таблиц из Google Drive
Google Docs
- Чтение содержимого документов
- Извлечение текста из документов
- Вставка текста в документы
- Удаление текста из документов
- Создание документов (опционально)
Google Drive
- Поиск файлов
- Скачивание Google Docs как TXT
- Обновление содержимого файлов
- Предоставление доступа к таблицам
Установка
# Клонирование репозитория
git clone https://github.com/yourusername/mcp-google-sheets.git
cd mcp-google-sheets
# Создание виртуального окружения
python -m venv venv
source venv/bin/activate # Linux/Mac
# или
venv\Scripts\activate # Windows
# Установка зависимостей
pip install -r requirements.txt
Настройка аутентификации
Способ 1: Service Account (рекомендуется)
- Создайте сервисный аккаунт в Google Cloud Console
- Скачайте JSON-файл с ключом
- Предоставьте сервисному аккаунту доступ к таблицам и диску
Укажите путь к файлу:
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json"
Способ 2: OAuth 2.0
- Создайте OAuth credentials в Google Cloud Console
- Скачайте
credentials.json - При первом запуске будет предложено авторизоваться через браузер
- Токен будет сохранён в
token.json
Переменные окружения
| Переменная | Описание | По умолчанию |
|---|---|---|
GOOGLE_APPLICATION_CREDENTIALS |
Путь к файлу сервисного аккаунта | service-account-key.json |
CREDENTIALS_CONFIG |
Base64-encoded JSON сервисного аккаунта | - |
DRIVE_FOLDER_ID |
ID папки в Google Drive для поиска таблиц | - |
ENABLE_CREATE_TOOLS |
Включить инструменты создания (true/false) |
false |
Запуск
python server.py
Использование с MCP-клиентами
Claude Desktop
Добавьте в claude_desktop_config.json:
{
"mcpServers": {
"google-sheets": {
"command": "python",
"args": ["/path/to/mcp-google-sheets/server.py"]
}
}
}
Инструменты
| Инструмент | Описание |
|---|---|
get_sheet_data |
Получить данные из листа |
get_sheet_formulas |
Получить формулы из ячеек |
update_cells |
Обновить значения ячеек |
batch_update_cells |
Пакетное обновление нескольких диапазонов |
add_rows |
Добавить строки |
add_columns |
Добавить столбцы |
list_sheets |
Получить список листов |
copy_sheet |
Копировать лист |
rename_sheet |
Переименовать лист |
delete_sheet |
Удалить лист |
list_spreadsheets |
Получить список таблиц |
share_spreadsheet |
Предоставить доступ к таблице |
get_doc_content |
Получить содержимое документа |
get_doc_text |
Получить текст документа |
search_drive_files |
Поиск файлов в Drive |
Лицензия
MIT
Tools (15)
get_sheet_dataGet data from a sheetget_sheet_formulasGet formulas from cellsupdate_cellsUpdate cell valuesbatch_update_cellsBatch update multiple rangesadd_rowsAdd rows to a sheetadd_columnsAdd columns to a sheetlist_sheetsGet a list of sheetscopy_sheetCopy a sheetrename_sheetRename a sheetdelete_sheetDelete a sheetlist_spreadsheetsGet a list of spreadsheetsshare_spreadsheetShare a spreadsheetget_doc_contentGet document contentget_doc_textGet document textsearch_drive_filesSearch for files in DriveEnvironment Variables
GOOGLE_APPLICATION_CREDENTIALSPath to the service account JSON fileCREDENTIALS_CONFIGBase64-encoded JSON of the service accountDRIVE_FOLDER_IDID of the Google Drive folder for searching tablesENABLE_CREATE_TOOLSEnable creation tools (true/false)Configuration
claude_desktop_config.json
{"mcpServers": {"google-sheets": {"command": "python", "args": ["/path/to/mcp-google-sheets/server.py"]}}}Try it
→List all the spreadsheets in my Google Drive.
→Read the data from the first sheet in the spreadsheet with ID '12345'.
→Search for files in my Drive containing the word 'Project'.
→Update the cells in range A1:B2 of my spreadsheet with new values.
→Extract the text content from the Google Doc with ID 'abcde'.