Claude CodeとgogcliでGmailを連携させると、未読確認・要約・Slack通知を3ステップで自動化できます。
- 要点1: gogcliをインストールしOAuth認証するだけでGmailをCLI操作できる(GCPプロジェクト不要)
- 要点2:
gog gmail search "is:unread"で未読メールを取得し、Claude Codeが要返信・FYI・対応不要に自動分類 - 要点3: cronジョブで毎朝自動チェック+Slack通知を設定することで、メール見逃しをゼロにできる
対象: Claude Codeを活用した業務自動化に取り組む経営者・DX推進担当者
今日やること: gogcliをインストールして gog auth login でGmail認証を完了させる
この記事の目次
Claude CodeとgogcliでGmailを接続することで、未読メールの確認・要約・Slack通知を数分で自動化できます。
「受信トレイを開くのが怖い」「重要なメールを見逃してしまう」——こうした課題は、メールの量が増えるにつれて多くのビジネスパーソンが直面します。McKinseyの調査によると、ビジネスパーソンは1日平均2.6時間をメール確認に費やしており、生産性向上の大きな障壁となっています。
この記事では、gogcliというCLIツールを使ってClaude CodeからGmailを操作し、未読確認・要約・Slack通知・下書き作成を自動化する手順をステップ別に解説します。
Claude CodeでGmailを自動化できる理由
Claude CodeでGmailを操作するためのカギは、gogcliという専用CLIツールにあります。gogcliを設定することで、Claude Codeから自然言語でGmail操作を指示でき、複雑なAPI実装なしにメール自動化を実現できます。
gogcliとは何か
gogcliは、GoogleWorkspace(Gmail、カレンダー、Drive、スプレッドシート等)をターミナルから操作できるオープンソースのCLIツールです。gog コマンド一つで複数のGoogleサービスを統一的に操作できます。
| 特徴 | 内容 |
|---|---|
| コマンド構文 | gog <サービス> <アクション> のシンプルな形式 |
| 対応サービス | Gmail、Calendar、Drive、Sheets、Contacts、Tasks等 |
| 認証方式 | OAuth2(一度設定すれば継続利用可能) |
| 出力形式 | JSON / plain(TSV)で切り替え可能 |
Claude Codeとgogcliを連携させるメリット
gogcliを単体で使う場合は手動でコマンドを入力する必要がありますが、Claude Codeのスキルと組み合わせることで次の3つのメリットが生まれます。
- 自然言語で指示できる: 「今日の未読メールで要返信のものを一覧にして」と指示するだけで、gogcliのコマンドを自動生成して実行
- 条件分岐の自動化: メール内容に応じて「要返信」「FYI」「対応不要」を自動判定し、処理を振り分け
- 他ツールとの連携: SlackへのWebhook通知、Googleカレンダーとの照合など、複数サービスを横断した業務フロー構築が可能
ある1人で複数事業を運営している経営者の事例では、gogcliとClaude Codeを連携させて「メール確認→未返信を検出→Slack DM通知」という自動アクションスキャナーを構築し、メール対応の見逃しを大幅に削減しました。
事前準備:認証設定とインストール
gogcliのインストール方法
gogcliはnpmで簡単にインストールできます。Node.js(v18以上)が必要です。
npm install -g gogcli
インストール確認:
gog --version
OAuth認証の設定手順
gogcliの認証はGoogle OAuth2を使用します。GCPプロジェクトの作成やAPIの手動有効化は不要で、以下のコマンドで自動的にブラウザが開き、Googleアカウントでの認証が完了します。
gog auth login
実行すると以下のようなURLが表示されます。ブラウザで開いて、使用するGoogleアカウント(会社のG Suiteアカウント等)でログインし、アクセスを許可してください。
認証URLが生成されました:https://accounts.google.com/o/oauth2/auth?...ブラウザで上記URLを開いてください。
認証が完了すると、トークンが ~/.config/gogcli/credentials.json に保存され、以後の操作でブラウザ認証なしでGmailを操作できます。
セキュリティに関するポイント認証情報はローカルに暗号化されて保存されます。社内のセキュリティポリシーに従い、認証情報ファイルのアクセス権限を適切に設定してください(
chmod 600 ~/.config/gogcli/credentials.json)。
対応スコープの確認
以下のコマンドで認証済みのスコープを確認できます。Gmail操作には gmail.modify スコープが必要です。
gog auth status
\ Claude Codeの導入、何から始めればいいかわかります /
法人向けClaude Code個別指導の無料相談はこちら基本操作:未読メールの検索と取得
設定が完了したら、基本的なGmail検索コマンドを試してみましょう。
未読メールを一覧表示する
# 未読メールを最大10件取得gog gmail search "is:unread" --max 10# 出力例ID | 送信者 | 件名 | 日時abc123 | tanaka@client.com | 【ご確認】打ち合わせ日程 | 2026-03-25 09:15def456 | noreply@service.com | メールマガジン | 2026-03-25 08:30
送信者・期間・ラベルで絞り込む
Gmailの検索演算子をそのまま使用できます。
# 過去24時間の重要メールgog gmail search "newer_than:1d is:important" --max 5# 特定の送信者からgog gmail search "from:client@example.com is:unread"# 件名にキーワードを含むgog gmail search "subject:見積 is:unread"# 複数条件の組み合わせ(24時間以内 AND 未読 AND 返信待ち)gog gmail search "newer_than:1d is:unread label:要返信"
メール本文の取得方法
メールIDを使って本文を取得します。
# 一覧から取得したIDを使って本文を取得gog gmail get abc123# JSON形式で出力(Claude Codeへの連携に便利)gog gmail get abc123 --format json
Claude Codeで受信メールを要約・分類する
取得したメール一覧をClaude Codeに渡すことで、内容の要約と重要度判定を自動化できます。
Claude Codeへの渡し方とプロンプト設計
Claude Codeのセッション内で以下のようにgogcliの出力を渡すプロンプトを使用します。
以下のメール一覧を確認し、各メールを「要返信」「FYI(参考情報)」「対応不要」の3つに分類してください。要返信のメールには、返信期限の目安と返信の優先度(高/中/低)も付けてください。[gog gmail search "is:unread" --max 20 の出力結果をここに貼り付け]
実際の運用では、Claude Codeのスキルとして設定することで、gog gmail search の実行からClaude Codeへの渡しまでを一括で自動化できます。
要返信 / FYI / 対応不要の3分類で整理
Claude Codeによる分類出力例:
【要返信(高優先度)】- 田中様からの打ち合わせ日程確認(2026-03-26まで) → 今日中の返信推奨【要返信(中優先度)】- 山田様からの資料送付依頼【FYI(参考情報)】- プロジェクト進捗レポート【対応不要】- メールマガジン × 5通
この出力を毎朝確認することで、受信トレイを全件確認しなくても優先対応すべきメールを把握できます。
Claude Codeの導入や活用方法について、個別にご相談いただけます。「どの業務から自動化を始めればよいか」「自社のメール管理フローに合った設定を知りたい」といった段階から対応しています。
Slack通知で見逃しゼロに:未返信メールの自動アラート
メール確認を自動化しても、結果を確認しなければ意味がありません。結果をSlackに自動通知することで、メールの見逃しを防ぐ仕組みを構築できます。
Slack Webhookの設定
- Slackの管理画面から「Incoming Webhooks」アプリを追加
- 通知先のチャンネル(例:
#自分のDMまたは#メール管理)を設定 - Webhook URLを取得(例:
https://hooks.slack.com/services/T00000/B00000/xxxxx)
取得したWebhook URLをシェルスクリプトに組み込みます。
#!/bin/bash# gmail-check.shSLACK_WEBHOOK="https://hooks.slack.com/services/T00000/B00000/xxxxx"# 未読かつ重要なメールを取得MAILS=$(gog gmail search "newer_than:1d is:unread is:important" --format json)if [ ! -z "$MAILS" ]; then # Slackに通知 curl -X POST -H 'Content-type: application/json' \ --data "{\"text\":\"📧 要確認メールが届いています:\\n${MAILS}\"}" \ $SLACK_WEBHOOKfi
cronジョブで毎朝自動チェック
作成したスクリプトをcronで定期実行します。Claude Code(OpenClaw)のcron機能、またはOS標準のcrontabを使用できます。
OS標準のcrontab(シンプルな方法):
crontab -e
以下を追加:
# 毎朝9時と18時にメールチェック0 9 * * * /bin/bash /path/to/gmail-check.sh0 18 * * * /bin/bash /path/to/gmail-check.sh
OpenClaw cronジョブとして設定する方法:
Claude Codeをベースにしたボット環境(OpenClaw)を使用している場合は、cronジョブとして設定することで、実行結果をより詳細なSlackメッセージとして送信できます。ある経営者の事例では、毎日9:00と18:00に「本日の未返信メール一覧」をSlackのDMに自動送信する仕組みを構築し、メール確認漏れによる対応遅延を防いでいます。
応用:下書き自動作成で返信を半自動化
単なるメール確認から一歩進んで、返信下書きの自動作成まで自動化できます。ただし、実際の送信は必ず人間が確認してから行う「Human in the Loop」設計が重要です。
下書き作成コマンドの使い方
# 基本的な下書き作成gog gmail draft create \ --to="tanaka@client.com" \ --subject="Re: 打ち合わせ日程について" \ --body="田中様\n\nご連絡いただきありがとうございます。..."# HTMLメール形式での下書きgog gmail draft create \ --to="tanaka@client.com" \ --subject="Re: ご提案の件" \ --body-html="<p>田中様</p><p>ご連絡いただきありがとうございます。</p>"
作成された下書きはGmailの「下書き」フォルダに保存され、ブラウザまたはモバイルアプリから確認・送信できます。
Claude Codeによる返信文生成との組み合わせ
Claude Codeに受信メールの内容を渡し、返信文を生成→gogcliで下書き保存するフローを構築できます。
[プロンプト例]以下のメールに対する返信文を作成してください。送信者名は「川島」、返信のトーンは丁寧かつ端的に。300文字以内でまとめてください。件名: 打ち合わせ日程について本文: [メール本文]
Claude Codeが生成した返信文を確認し、問題なければ gog gmail draft create で下書き保存します。
人間確認フローの設計(誤送信防止)
メール自動化で最も重要なのは「誤送信防止」です。以下のフローを徹底することを推奨します。
| フェーズ | 実行者 | 内容 |
|---|---|---|
| 1. メール取得 | Claude Code + gogcli | 未読・重要メールを取得 |
| 2. 要約・分類 | Claude Code | 要返信/FYI/対応不要を判定 |
| 3. 返信文生成 | Claude Code | 下書き本文を生成 |
| 4. 下書き保存 | gogcli | Gmailの下書きに保存 |
| 5. 内容確認 | 人間 | 下書きを読んで問題ないか確認 |
| 6. 送信実行 | 人間 | 送信ボタンを押す |
「AI生成→下書き保存→人間確認→送信」の4段階フローにより、自動化のスピードと品質管理を両立できます。
\ 業務自動化のお悩み、プロが30分で整理します /
法人向けClaude Code個別指導の無料相談はこちらよくある質問
Q. gogcliとGmail APIを直接使う場合の違いは何ですか?
gogcliはGmail APIのラッパーツールです。Gmail APIを直接使う場合はGCPプロジェクトの作成、APIの有効化、認証情報のJSON発行などの初期設定が必要ですが、gogcliを使うことでこれらの手順を省略できます。エンジニアでなくても設定できるのがgogcliの大きな利点です。一方、細かいAPIパラメータの制御が必要な場合やカスタム認証が必要な企業システムとの連携では、Gmail APIを直接使う方が柔軟性が高い場合もあります。
Q. Gmail自動化でセキュリティ上のリスクはありますか?
主なリスクと対策は以下の通りです。
| リスク | 対策 |
|---|---|
| 認証トークンの漏洩 | credentials.json のファイルアクセス権限を制限(chmod 600)、.gitignoreに追加 |
| 誤送信 | 必ず「下書き保存→人間確認→送信」のフローを守る。gog gmail send は慎重に使用 |
| 過剰な権限付与 | 必要最小限のスコープのみ付与(読み取りのみの場合は gmail.readonly) |
Q. Claude Codeのスキルとして設定するメリットは何ですか?
スキルとして設定することで、「今日の未読メールを確認して」という自然言語の指示だけでgogcliコマンドの生成・実行・結果の要約まで自動的に処理されます。毎回コマンドを入力する手間がなくなり、複数のコマンドを組み合わせた処理(検索→要約→Slack通知)を1回の指示で実行できるようになります。
まとめ
Claude CodeとgogcliでGmailを連携させることで、以下の自動化フローを構築できます。
- gogcliのインストール・認証:
npm install -g gogcli→gog auth login - 未読メールの取得:
gog gmail search "is:unread"で検索クエリを活用 - Claude Codeによる要約・分類: 要返信/FYI/対応不要を自動判定
- Slackへの自動通知: cronジョブで毎朝定期実行
- 下書き自動作成: Human in the Loopで誤送信を防止
1日2.6時間のメール確認時間を大幅に削減し、重要なメールへの対応スピードを向上させることができます。まずはgogcliのインストールとGmail認証から試してみてください。
Claude Codeの導入・活用をサポートします
株式会社Nexaでは、Claude Codeを活用した業務自動化の個別指導・企業研修を提供しています。「Gmail自動化の設定をサポートしてほしい」「自社のメール管理フローに合った仕組みを一緒に構築したい」という方は、まずは無料相談からお気軽にどうぞ。





