Google Drive MCP Server

Локальный MCP-сервер на Python для чтения и записи Google Sheets, Slides и Drive из сессий Claude Code.

Как работает

Сервер использует OAuth 2.0 Desktop App от GCP. При первом использовании открывается браузер для потока согласия. После одобрения сохраняется локальный token.json. При последующих запусках токен используется повторно и автоматически обновляется по истечении срока действия — без необходимости снова открывать браузер.

Файлы аутентификации:

Related MCP server: google-workspace-mcp-with-script

Первоначальная настройка (в первый раз)

1. Учётные данные GCP

1. Перейдите в GCP Console → APIs & Services → Credentials

2. Создайте OAuth 2.0 Client ID (тип: Desktop App)

3. Скачайте JSON и сохраните как credentials.json в этой папке

4. Включите API в проекте GCP:

   • Google Sheets API

   • Google Slides API

   • Google Drive API

2. Установка зависимостей

Windows (PowerShell):

cd "C:\Users\<usuario>\Documents\MCP_Servers\googleDrive"
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

macOS / Linux:

cd ~/Documents/MCP_Servers/googleDrive
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. Первый вход (OAuth)

Выполните вручную, чтобы открыть браузер и авторизовать:

Windows:

.venv\Scripts\activate
python main.py

macOS / Linux:

source .venv/bin/activate
python main.py

После одобрения в браузере создаётся token.json, и сервер запускается. Можно остановить его с помощью Ctrl+C — токен сохранится для будущих запусков.

Регистрация в Claude Code

Есть два способа зарегистрировать MCP-сервер:

Вариант A — Для проекта (.mcp.json)

Создаёт файл .mcp.json в корне проекта. MCP будет активен только в этом проекте.

Windows:

{
  "mcpServers": {
    "google-drive": {
      "type": "stdio",
      "command": "C:\\Users\\<usuario>\\Documents\\MCP_Servers\\googleDrive\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\Users\\<usuario>\\Documents\\MCP_Servers\\googleDrive\\main.py"
      ]
    }
  }
}

macOS / Linux:

{
  "mcpServers": {
    "google-drive": {
      "type": "stdio",
      "command": "/Users/<usuario>/Documents/MCP_Servers/googleDrive/.venv/bin/python",
      "args": [
        "/Users/<usuario>/Documents/MCP_Servers/googleDrive/main.py"
      ]
    }
  }
}

Вариант B — Глобально для пользователя (~/.claude/settings.json)

Добавляет MCP в глобальные настройки Claude Code — становится доступен во всех проектах.

Отредактируйте ~/.claude/settings.json (Windows: C:\Users\<usuario>\.claude\settings.json) и добавьте ключ mcpServers:

Windows:

{
  "mcpServers": {
    "google-drive": {
      "type": "stdio",
      "command": "C:\\Users\\<usuario>\\Documents\\MCP_Servers\\googleDrive\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\Users\\<usuario>\\Documents\\MCP_Servers\\googleDrive\\main.py"
      ]
    }
  }
}

macOS / Linux:

{
  "mcpServers": {
    "google-drive": {
      "type": "stdio",
      "command": "/Users/<usuario>/Documents/MCP_Servers/googleDrive/.venv/bin/python",
      "args": [
        "/Users/<usuario>/Documents/MCP_Servers/googleDrive/main.py"
      ]
    }
  }
}

Используйте Вариант A, когда MCP специфичен для проекта. Используйте Вариант B, когда нужен доступ в любом проекте.

Переменные окружения (опционально)

По умолчанию сервер ищет credentials.json и token.json в своей папке. Чтобы изменить пути, создайте .env на основе .env.example:

GOOGLE_CREDENTIALS_PATH=credentials.json
GOOGLE_TOKEN_PATH=token.json

Доступные инструменты (17 tools)

Google Sheets (7)

Google Slides (7)

Google Drive (3)

Все инструменты принимают прямой ID или полный URL Google:

• 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms

• https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms/edit

Troubleshooting

invalid_grant / токен истёк без автоматического продления

Удалите token.json и снова запустите python main.py, чтобы заново пройти поток OAuth.

Windows:

Remove-Item ".\token.json"
python main.py

macOS / Linux:

rm token.json
python main.py

API не включена

Проверьте, что три API активны в GCP Console: Google Sheets API, Google Slides API, Google Drive API.

MCP не отображается в Claude Code

Проверьте, что путь к исполняемому файлу Python указан верно:

• Windows: .venv\Scripts\python.exe

• macOS/Linux: .venv/bin/python

Используйте абсолютный путь в .mcp.json или settings.json — относительные пути не работают.