毎週月曜の朝、同じことを繰り返していました。Gmail を開いて未読を処理し、カレンダーで今週の予定を確認して、Google Sheets のタスク管理シートにステータスを記入します。エンジニアリングの仕事をしながら、なぜこんなに管理作業に時間を使っているのかと感じていました。
Antigravity の MCP ツール経由で Google Workspace と連携させてから、この一連の作業がコードエディタを離れずにできるようになりました。「未読メールの要件定義関連だけ要約して」「今週の空き時間を Sheets の予定表に反映して」— これをコーディングの合間に自然言語で指示できるのは、単純に作業の流れが変わります。
Google Workspace MCP を Antigravity に設定する手順と、実際に使って効果的だったワークフローパターンを順番にご紹介します。
Google Workspace MCP でできること
MCP(Model Context Protocol)は、AI ツールが外部サービスと安全に通信するための標準プロトコルです。Antigravity はこの MCP に対応しており、Google が提供する公式 MCP サーバーや、コミュニティ製のサーバーを経由して、Google Workspace のデータにアクセスできます。
MCP 経由で操作できる主なサービスは以下のとおりです:
- Gmail: 未読取得・検索・送信・ラベル管理
- Google Calendar: 予定の取得・作成・更新・空き時間確認
- Google Sheets: セルの読み書き・シートへのデータ追加・行の更新
- Google Drive: ファイル一覧・検索・ドキュメント内容の読み取り
従来の API 連携との大きな違いは、MCP 経由の場合は Antigravity の AI エンジンが「どの API をいつ呼ぶか」を判断してくれる点です。明示的なスクリプトを書かなくても自然言語で操作できます。MCP の仕組みについてより詳しく知りたい場合は、Antigravity MCP エコシステム 2026 年版ガイドが参考になります。
Google Workspace MCP のセットアップ
前提条件
- Google Cloud プロジェクト(無料枠で可)
- Antigravity 最新バージョン(2.0 以降)
- Python 3.11 以上
1. Google Cloud での API 有効化と認証情報取得
まず Google Cloud Console でプロジェクトを用意し、必要な API を有効化します。
# Google Cloud CLI で必要な API を一括有効化
gcloud services enable gmail.googleapis.com \
calendar-json.googleapis.com \
sheets.googleapis.com \
drive.googleapis.com次に、OAuth 2.0 の認証情報を作成します。Google Cloud Console の「認証情報」画面から「OAuth クライアント ID」を選び、「デスクトップアプリ」タイプで作成してください。リダイレクト URI に http://localhost:8080 を追加しておきます。
作成した client_secret_*.json ファイルを安全な場所(たとえば ~/.config/google/client_secret.json)に保存します。
2. MCP サーバーのインストールと初期認証
# Python 製 Google Workspace MCP サーバーをインストール
pip install mcp-google-workspace
# 初回認証(ブラウザが開いて OAuth 認証フローが始まります)
mcp-google-workspace auth --client-secret ~/.config/google/client_secret.json
# 必要なスコープを明示する場合(送信権限を含む場合の例)
mcp-google-workspace auth \
--scopes gmail.readonly,gmail.send,calendar,sheets,drive.readonly認証が完了すると ~/.config/mcp-google-workspace/credentials.json にトークンが保存されます。
3. Antigravity の MCP 設定に追加
Antigravity の設定(IDE 内の Settings → MCP、または .antigravity/settings.json)に以下を追記します:
{
"mcpServers": {
"google-workspace": {
"command": "mcp-google-workspace",
"args": ["serve"],
"env": {
"MCP_GOOGLE_CREDENTIALS": "~/.config/mcp-google-workspace/credentials.json"
}
}
}
}設定後に Antigravity を再起動すると、チャット欄で Google Workspace ツールが利用可能になります。MCP Store から設定ファイルのテンプレートを取得する方法については、MCP Store 活用ガイドに詳しくまとめています。
Gmail との連携 — メール処理をコーディングの合間にこなす
設定が完了したら、Antigravity のチャット欄でこのように入力してみてください:
「今日届いた未読メールのうち、件名に『GitHub』や『エラー』が含まれるものを要約して」
Antigravity は Gmail から未読メールを取得してフィルタリングし、要約して返します。実際に使ってみて、週に 30 分ほどのメール確認時間が半分以下になりました。
よく使うパターンをいくつか紹介します:
- 「先週受け取ったプルリクエストレビュー依頼メールを一覧で出して」
- 「送信済みのうち返信のないものを古い順に教えて」
- 「〇〇さんからのメールを過去 1 ヶ月分すべてまとめて」
返信草稿を作りたい場合は続けて指示できます:
「3 番目のメールに対して簡単な返信草稿を作って。
口調は丁寧にして、受け取った旨と 2 日以内に詳細を送る旨を書いて」
確認後に「送信して」と入力すると送信されます。Antigravity は送信前に必ず内容を提示して確認を求めるので、意図しない送信は起きません。
Google Calendar との連携 — 開発スケジュールを手元で把握する
カレンダーとの連携が特に便利なのは、コーディング中にウィンドウを切り替えずに予定確認ができる点です。
「今日の残り時間でできるタスクを見積もって。
カレンダーの予定を見た上で、集中できる 2 時間以上のブロックが何時にあるか教えて」
この指示に対して Antigravity はカレンダーから今日の予定を取得し、空き時間を計算して回答します。
予定を追加する場合:
「来週の火曜 15 時から 1 時間のミーティングを
『設計レビュー』というタイトルで入れて。
説明欄には『Q2 機能のデモ確認』と書いて」
ミーティングの調整でよく使うパターン:
- 「今月の残りの 1on1 の日程を全部教えて」
- 「今週末のコーディングセッション用に土曜午前 3 時間ブロックして」
- 「次の 2 週間で両者とも空いている 1 時間を候補で出して(チームメンバーのカレンダーが共有されている場合)」
よくある詰まりポイントと対処法
実際にセットアップしてみると特定のパターンでエラーが出やすいです。遭遇しやすい問題を2つ取り上げます。
OAuth トークンの期限切れ
長時間の作業後に急に「認証エラー」が出ることがあります。OAuth アクセストークンは通常 1 時間で期限切れになります。
# 認証情報の再取得
mcp-google-workspace auth --refresh
# 自動リフレッシュを有効にしておく設定
mcp-google-workspace config set auto_refresh true自動リフレッシュを設定しておくと作業中断が減ります。
スコープ不足エラー
「この操作を実行できません」という応答が返る場合、設定したスコープに必要な権限が含まれていないことがあります。たとえばメール送信には gmail.send が必要ですが、読み取り専用スコープしか設定していないケースが多いです。
# スコープを確認して必要なものを追加して再認証
mcp-google-workspace auth \
--scopes gmail.readonly,gmail.send,calendar,sheets \
--force設定したスコープは Google アカウントのアプリ権限ページ(myaccount.google.com/permissions)で確認・削除もできます。
Google Workspace 連携をエージェントとして自動化する方向に発展させたい場合は、Antigravity × Google Workspace エージェント自動化ガイドが参考になります。
次のステップ
Google Workspace との MCP 連携を一度設定してしまえば、エディタを離れずにメール・カレンダー・Sheets を操作できるようになります。設定はやや手間ですが、毎日使う作業なら初日に回収できる投資です。
まず試すなら Gmail の未読整理から始めてみてください。「今日の未読のうち返信が必要なものを優先度順に並べて」— この一言で何が返ってくるかを見てみると、連携の可能性が実感できます。慣れてきたら Sheets との連携を加えて、タスク管理や進捗更新もエディタから完結する流れを作っていくのがおすすめです。