Google Docs、Sheets、Drive、Gmail、Calendar MCP サーバー

概要 – Google Workspace API（Docs、Sheets、Drive、Gmail、Calendar、Apps Script）を、Claude Desktop、Cursor、または MCP 互換クライアントなどの AI エージェントが呼び出し可能なツールとして公開する Node ベースの MCP（マルチクライアントプロトコル）サーバーです。

仕組み –

1. Google Cloud OAuth クライアントを作成し、必要な Workspace API を有効にします。
2. npx @a-bonus/google-docs-mcp auth を実行して、ローカルに保存されるリフレッシュトークンを取得します。
3. MCP クライアント設定にサーバー定義を追加します。クライアントは必要に応じてサーバーを起動します（または、共有リモートエンドポイントとして Cloud Run にデプロイできます）。
4. サーバーは MCP 呼び出しを Google API リクエストに変換し、構造化された JSON 結果を返します。

主な機能 –

• Docs: プレーンテキスト、Markdown、テーブル、画像、スタイル、コメント、タブ、セクションなどの読み書き。
• Sheets: 範囲の読み書き、バッチ更新、書式設定、テーブル、グラフ、条件付き書式、保護、ドロップダウンなど。
• Drive: ファイル/フォルダの一覧表示、検索、作成、移動、コピー、名前変更、削除、コンテンツのダウンロード。
• Gmail: メッセージの一覧表示/検索、本文全体の読み取り、送信/返信、下書き、ラベル、ゴミ箱の管理、複合 triageInbox ヘルパー。
• Calendar: イベントの一覧表示/検索、作成/更新/削除、自然言語でのクイック追加。
• Apps Script: バインドされた、またはスタンドアロンのスクリプトプロジェクトの作成、読み取り、更新。

典型的なユースケース – LLM を搭載したアシスタントが「ドキュメント ABC123 に『会議メモ』を追加」や「スプレッドシート XYZ789 に『タスク』という名前のテーブルを作成」などの自然言語コマンドを発行し、MCP クライアントがこのサーバーに転送し、サーバーが適切な Google API を呼び出して結果を返します。

デプロイオプション –

• ローカル: 開発マシンで npx を介して実行。トークンは ~/.config/google-docs-mcp/token.json に保存されます。
• リモート: コンテナを Google Cloud Run（または任意のコンテナホスト）にデプロイします。サーバーは MCP OAuth 2.1 を使用するため、クライアントが Google サインインを自動的に処理します。ローカルトークンは不要です。

セットアップのハイライト –

• Google Cloud で Docs、Sheets、Drive、Gmail、Calendar、Apps Script API を有効にします。
• GOOGLE_CLIENT_ID、GOOGLE_CLIENT_SECRET を提供します（リモートモードではオプションで TOKEN_STORE=firestore、JWT_SIGNING_KEY も）。
• 提供された JSON スニペットを使用して、サーバーを MCP クライアント設定に追加します。

重要性 – 強力な LLM エージェントと完全な Google Workspace スイートを橋渡しし、AI アシスタントが毎回カスタム OAuth コードを書くことなく、ドキュメント、スプレッドシート、メール、カレンダーをプログラムで読み取り、編集、調整できるようにします。

---

クイックスタート

# 1. 認証
GOOGLE_CLIENT_ID=… GOOGLE_CLIENT_SECRET=… npx -y @a-bonus/google-docs-mcp auth

# 2. クライアントに追加（Claude Desktop / Cursor）
{
  "mcpServers": {"google-docs": {"command": "npx","args": ["-y","@a-bonus/google-docs-mcp"],"env": {"GOOGLE_CLIENT_ID":"…","GOOGLE_CLIENT_SECRET":"…"}}}
}

リモートデプロイ例

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"

---

すべての詳細はリポジトリの README から直接取得されています。