Google Drive MCP for GigaCowork
Provides tools for creating Google Docs from Markdown, appending and inserting text, replacing text, and filling templates with multiple replacements.
Provides tools for searching, reading, downloading, uploading, updating, copying, moving, renaming, deleting, restoring, and sharing files and folders on Google Drive, including Shared Drives and permission management.
Provides tools for creating Google Sheets, reading sheet metadata and cell data, writing and appending rows, clearing ranges, and adding new sheets.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Google Drive MCP for GigaCowork
MCP-коннектор (Model Context Protocol) для Google Drive. Через него AI-ассистент или AI-платформа может искать, читать, скачивать, загружать и менять файлы на диске, а также работать с Google Docs и Google Sheets.
Поддерживает stdio (Claude Desktop) и HTTP (streamable-http / sse), так что его можно разместить на своём сервере и подключить к платформе по URL.
Возможности (29 инструментов)
Группа | Инструменты |
Обзор и поиск |
|
Чтение |
|
Скачивание |
|
Загрузка и изменение |
|
Управление |
|
Доступ |
|
Google Docs |
|
Google Sheets |
|
Общие диски (Shared Drives) поддерживаются во всех операциях. Через GDRIVE_ROOT_FOLDER_ID можно задать папку по умолчанию для поиска и загрузки.
Related MCP server: MCP Google Drive Server
1. Настройка Google Cloud (один раз)
Откройте https://console.cloud.google.com/ и создайте проект (например,
gdrive-mcp).APIs & Services → Library — включите три API:
Google Drive API
Google Docs API
Google Sheets API
Дальше выберите способ авторизации.
Вариант A — OAuth пользователя через браузер (рекомендуется)
Самый простой способ: коннектор сам проводит вход в Google и сохраняет токен в token.json.
Google Auth Platform → Branding: укажите Home page
https://<ваш-домен>/и Privacy policyhttps://<ваш-домен>/privacy(эти страницы отдаёт сам коннектор), добавьте домен в Authorized domains.Audience → Publish app (статус In production), иначе токен живёт 7 дней.
Clients → Create client → Web application, Authorized redirect URI:
https://<ваш-домен>/oauth/callback.В
.env:GOOGLE_CLIENT_ID,GOOGLE_CLIENT_SECRET,GOOGLE_OAUTH_REDIRECT_URI=https://<ваш-домен>/oauth/callback,MCP_AUTH_TOKEN.Владелец диска открывает
https://<ваш-домен>/oauth/start?token=<MCP_AUTH_TOKEN>, входит в Google и нажимает «Продолжить». Появится «Google Drive подключён ✅».
Вариант A2 — OAuth через скрипт на своём компьютере
APIs & Services → OAuth consent screen (или Google Auth Platform):
User type: External (или Internal, если у вас Google Workspace).
Заполните название приложения и email.
Scopes добавлять не обязательно.
Важно: переведите приложение в статус In production (Publish app). В статусе Testing refresh-токен перестаёт работать через 7 дней. Проходить верификацию Google для собственного использования не нужно: при входе просто появится предупреждение «Приложение не проверено» → Дополнительно → Перейти.
Credentials → Create credentials → OAuth client ID → тип Desktop app. Скачайте JSON и переименуйте в
client_secret.json.На своём компьютере:
pip install google-auth-oauthlib python get_token.py client_secret.jsonОткроется браузер: войдите в аккаунт, к диску которого нужен доступ, и разрешите доступ. Скрипт выведет
GOOGLE_CLIENT_ID,GOOGLE_CLIENT_SECRETиGOOGLE_REFRESH_TOKEN— добавьте их в.envна сервере.
Вариант B — сервисный аккаунт (для общих дисков или Google Workspace)
IAM & Admin → Service Accounts → Create → затем Keys → Add key → JSON.
Откройте доступ к нужной папке или общему диску для email сервисного аккаунта (
...@...iam.gserviceaccount.com).Укажите путь к ключу в
GOOGLE_SERVICE_ACCOUNT_FILE(или вставьте JSON целиком вGOOGLE_SERVICE_ACCOUNT_JSON).
⚠️ У сервисного аккаунта нет своего места на диске. Читать и править файлы в расшаренной папке он может, но загружать новые файлы в обычный «Мой диск» не получится (ошибка storage quota exceeded). Загрузка работает только в общий диск (Shared Drive). Если общих дисков нет, используйте вариант A.
2. Запуск локально (Claude Desktop, stdio)
git clone https://github.com/otstoyotstoy/GoogleDrive-MCP-for-GigaCowork.git gdrive-mcp
cd gdrive-mcp
pip install -r requirements.txtclaude_desktop_config.json:
{
"mcpServers": {
"gdrive": {
"command": "python",
"args": ["C:/path/to/gdrive-mcp/server.py"],
"env": {
"MCP_TRANSPORT": "stdio",
"GOOGLE_CLIENT_ID": "...",
"GOOGLE_CLIENT_SECRET": "...",
"GOOGLE_REFRESH_TOKEN": "..."
}
}
}
}3. Деплой на VPS (HTTP, для подключения к AI-платформе)
Вариант 1: systemd
sudo mkdir -p /opt/gdrive-mcp && cd /opt/gdrive-mcp
sudo git clone https://github.com/otstoyotstoy/GoogleDrive-MCP-for-GigaCowork.git .
sudo python3 -m venv venv
sudo venv/bin/pip install -r requirements.txt
sudo cp .env.example .env && sudo nano .env # заполнить ключи Google и MCP_AUTH_TOKEN
openssl rand -hex 32 # сгенерировать MCP_AUTH_TOKEN
sudo chown -R www-data:www-data /opt/gdrive-mcp
sudo cp deploy/gdrive-mcp.service /etc/systemd/system/
sudo systemctl daemon-reload && sudo systemctl enable --now gdrive-mcp
curl http://127.0.0.1:8000/health # {"status":"ok"}Вариант 1б: виртуальный хостинг с Passenger (reg.ru, ispmanager)
В ispmanager создайте сайт-поддомен, в его настройках включите CGI-скрипты → Python 3.12 и выпустите сертификат Let's Encrypt.
Положите код в
~/gdrive-mcp, создайте venv:/opt/python/python-3.12/bin/python3 -m venv venv && venv/bin/pip install -r requirements.txt, заполните.env.В папку сайта положите
passenger_wsgi.py:import sys, runpy sys.path.insert(0, "/var/www/<user>/data/gdrive-mcp/venv/lib/python3.12/site-packages") application = runpy.run_path("/var/www/<user>/data/gdrive-mcp/passenger_wsgi.py")["application"]Перезапуск после изменений:
touch ~/www/<сайт>/tmp/restart.txt.
Вариант 2: Docker
cp .env.example .env && nano .env
docker compose up -d --buildnginx + HTTPS
sudo cp deploy/nginx.conf /etc/nginx/sites-available/gdrive-mcp # заменить gdrive.example.ru на свой домен
sudo ln -s /etc/nginx/sites-available/gdrive-mcp /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d gdrive.example.ruВ .env укажите MCP_ALLOWED_HOSTS=gdrive.example.ru.
Подключение к GigaCowork / другой MCP-платформе
Параметр | Значение |
URL (streamable-http) |
|
URL (sse, если платформа поддерживает только SSE) |
|
Авторизация | заголовок |
Если платформа не умеет заголовки |
|
Также принимается заголовок X-API-Key: <MCP_AUTH_TOKEN>.
GigaCowork: если при создании интеграции появляется ошибка
server responded with HTTP 401, платформа не передала токен. Самый надёжный вариант — указать токен прямо в MCP URL (.../mcp?token=...) и выбрать «без авторизации».
Формулы в Google Таблицах
Формулы записываются в синтаксисе локали таблицы. Для русской локали (ru_RU) разделитель аргументов — ; (=SUMIFS(A:A;B:B;"Закрыта")). Подсказка об этом уже есть в описании инструментов sheets_write / sheets_append.
Переменные окружения
Переменная | Описание |
| OAuth пользователя (вариант A) |
| сервисный аккаунт (вариант B) |
| Workspace: от чьего имени действовать (domain-wide delegation) |
| адрес возврата для входа через браузер ( |
| где хранить refresh-токен после входа через браузер (по умолчанию |
| папка по умолчанию для списка, поиска и загрузки |
|
|
| адрес и порт HTTP-сервера (по умолчанию |
| секрет для доступа к коннектору по HTTP (обязательно задать на сервере) |
| домены через запятую: включает защиту от DNS rebinding |
|
|
| лимиты размера файлов (20 / 50 МБ) |
| максимум символов, которые |
Примеры запросов к ассистенту
«Найди на диске договоры за ноябрь и прочитай последний»
«Загрузи этот отчёт в папку "Клиенты/Ромашка" как Google Doc»
«В таблице "Продажи 2026" добавь строку: 17.11, ООО Ромашка, 150 000»
«Возьми шаблон договора, сделай копию и подставь реквизиты клиента вместо {{...}}»
«Дай доступ на редактирование к папке "Проект X" для ivan@company.ru»
Безопасность
Никогда не коммитьте
.env,client_secret.jsonи ключи сервисного аккаунта (они уже в.gitignore).На сервере обязательно задайте
MCP_AUTH_TOKENи работайте только через HTTPS.Чтобы жёстко ограничить доступ одной папкой, используйте сервисный аккаунт и откройте ему только эту папку.
GDRIVE_ROOT_FOLDER_IDзадаёт только папку по умолчанию и не запрещает доступ к другим файлам по ID.delete_fileпо умолчанию перемещает файлы в корзину; безвозвратное удаление делается только сpermanent=true.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect an AI assistant to your Google Sheets, Drive, Docs, PDFs, BigQuery and Gmail.
Give Claude only the Google Drive files you choose. Every action logged.
Connect AI assistants to Google Sheets through controlled tools for reading and updating rows.
Swiss encrypted cloud drive for Claude, ChatGPT and AI agents: search, read and save files.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceConnects AI assistants like Claude to Google Drive, enabling them to browse, read, search, create, and edit files and folders using Google's official API with secure authentication.-
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Google Drive, supporting file operations like list, search, read, create, update, delete, share, and manage permissions.7405 npm4MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Google Drive, including reading, searching, listing folders, and uploading files.71MIT
- FlicenseNot gradedqualityDmaintenanceEnables MCP-compatible AI assistants to interact with a user's Google Drive, including listing, searching, reading, creating, updating, and deleting files, with authentication via Google OAuth.1-