Claude Desktop、カーソル、または任意のMCPクライアントをGoogleドキュメント、Google Sheets、Googleドライブ、Gmail、Googleカレンダーに接続してください。

---

クイックスタート

1.Google Cloud OAuth クライアントを作成する

1. Google Cloud Consoleへ
2. プロジェクトの作成または選択
3. Google Docs API、Google Sheets API、Google Drive API、Gmail API、Google カレンダー API を有効にしてください
4. OAuth同意画面の設定(外部で、メールアドレスをテストユーザーとして追加し、gmail.modify]およびcalendar.eventsスコープをDocs/Sheets/Driveスコープに加えて追加)
5. OAuthクライアントID(デスクトップアプリタイプ)を作成する
6. 確認画面からクライアントIDおよびクライアントシークレットをコピーします

もっと詳しく知りたいですか?このページの下部にあるステップバイステップの手順をご覧ください。

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