Подключите Claude Desktop, Cursor или любой MCP-клиент к вашему Google Docs, Google Sheets, Google Drive, Gmail и Google Calendar.

---

Быстрый старт

1. Создайте Google Cloud OAuth клиент

1. Зайдите в Google Cloud Console
2. Создайте или выберите проект
3. Включите API Google Docs, API Google Sheets, API Google Drive, API Gmail и API Google Calendar
4. Настройте экран OAuth согласие (внешний, добавьте свой email как тестового пользователя и добавьте прицелы gmail.modify и calendar.events вместе с Docs/Sheets/Drive scopes)
5. Создать OAuth client ID (тип десктопного приложения)
6. Скопируйте Client ID и Client Secret с экрана подтверждения

Нужны подробные детали? Смотрите пошаговые инструкции внизу этой страницы.

2. Авторизация

Это открывает ваш браузер для авторизации Google. После одобрения токен обновления сохраняется в ~/.config/google-docs-mcp/token.json.

3. Добавить к вашему клиенту MCP

Claude Desktop / Курсор / Виндсерфинг:

Сервер запускается автоматически, когда ваш MCP-клиент нуждается в этом.

Удалённое развертывание (облачный запуск)

Разверните один раз для своей команды — локальные установки не требуются. Сервер использует MCP OAuth 2.

Google Docs, Sheets, Drive, Gmail & Calendar MCP Server

Connect Claude Desktop, Cursor, or any MCP client to your Google Docs, Google Sheets, Google Drive, Gmail, and Google Calendar.

---

Quick Start

1. Create a Google Cloud OAuth Client

1. Go to the Google Cloud Console
2. Create or select a project
3. Enable the Google Docs API, Google Sheets API, Google Drive API, Gmail API, and Google Calendar API
4. Configure the OAuth consent screen (External, add your email as a test user, and add the gmail.modify and calendar.events scopes alongside the Docs/Sheets/Drive scopes)
5. Create an OAuth client ID (Desktop app type)
6. Copy the Client ID and Client Secret from the confirmation screen

Need more detail? See step-by-step instructions at the bottom of this page.

2. Authorize

GOOGLE_CLIENT_ID="your-client-id" \
GOOGLE_CLIENT_SECRET="your-client-secret" \
npx -y @a-bonus/google-docs-mcp auth

This opens your browser for Google authorization. After you approve, the refresh token is saved to ~/.config/google-docs-mcp/token.json.

3. Add to Your MCP Client

Claude Desktop / Cursor / Windsurf:

{
  "mcpServers": {
    "google-docs": {
      "command": "npx",
      "args": ["-y", "@a-bonus/google-docs-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

The server starts automatically when your MCP client needs it.

Remote Deployment (Cloud Run)

Deploy once for your team – no local installs required. The server uses MCP OAuth 2.1 so your MCP client handles authentication automatically.

gcloud run deploy google-docs-mcp \
  --source . \
  --region europe-west3 \
  --port 8080 \
  --allow-unauthenticated \
  --set-env-vars "^|^MCP_TRANSPORT=httpStream|BASE_URL=https://your-service.run.app|GOOGLE_CLIENT_ID=...|GOOGLE_CLIENT_SECRET=...|TOKEN_STORE=firestore|JWT_SIGNING_KEY=your-secret-key"

Then each user just adds the URL to their MCP client – no npx, no tokens, no local setup:

{
  "mcpServers": {
    "google-docs": {
      "type": "streamableHttp",
      "url": "https://your-service.run.app/mcp"
    }
  }
}

Your MCP client will prompt for Google sign-in on first connection. See Remote Deployment for details.

---

What Can It Do?

Tools across Google Docs, Sheets, and Drive:

Google Docs