ANTIGRAVITY LABEN
記事一覧/連携・プラグイン
連携・プラグイン/2026-05-04初級

Antigravity から Gmail を操作するまで:Google Workspace MCP の設定と実践パターン

Gmail・Google カレンダー・Sheets の操作を Antigravity から AI で直接実行できる MCP 連携の設定手順と実用的なワークフロー例を解説。日常の繰り返し作業を減らすための具体的なセットアップ付き。

google-workspace2mcp14gmailgoogle-calendargoogle-sheetsautomation51

毎週月曜の朝、同じことを繰り返していました。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 との連携を加えて、タスク管理や進捗更新もエディタから完結する流れを作っていくのがおすすめです。

シェア

お読みいただきありがとうございます

Antigravity Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • コピー&ペーストで使える実装コード付き
  • 毎日新しい上級ガイドを追加
  • ¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

もしこの記事がお役に立ちましたら、チップ(¥150)で応援いただけると大変励みになります。広告なしでの運営を続けるため、皆さまのご支援が大きな力になっています。

関連記事

連携・プラグイン2026-04-09
Antigravity × Notion API連携:ドキュメント駆動開発を自動化するAIワークフロー
AntigravityとNotion APIを連携させ、仕様書からコード・テスト・PR説明文まで自動生成するドキュメント駆動開発(DDD)ワークフローを完全解説。MCPサーバー構築から本番運用まで。
連携・プラグイン2026-03-27
Antigravity × GitHub Issues からコードを自動生成する AI ワークフロー構築ガイド
Antigravity の AI エージェントと GitHub Issues を連携し、Issue の内容からコードを自動生成するワークフローを構築する方法を解説します。MCP サーバーと AGENTS.md の設定から実践的な運用テクニックまで網羅。
連携・プラグイン2026-07-15
無人ランで作業フォルダが突然『別の人の持ち物』になる — 所有者ドリフトを検知して書ける場所へ逃がす
数週間緑だった無人スケジュールが、ある朝 git config を書けずに止まりました。原因は永続作業フォルダの所有者ドリフト。存在チェックでは通り書き込みだけが弾かれる罠を切り分け、書込可否を実測して別の場所へ逃がすプリフライトを実装まで残します。
📚RECOMMENDED BOOKS
大規模言語モデル入門
山田育矢
LLM開発
生成AIプロンプトエンジニアリング入門
我妻幸長
プロンプト
Claude CodeによるAI駆動開発入門
平川知秀
AI駆動開発
※ アフィリエイトリンクを含みます
もっと見る →