朝7時。

デスクに座って、コーヒーをひと口飲んでから Gmail を開く。

未読は58通。プロモーション11通、ニュースレター9通、本当に返信が必要なのは7通。残りは「念のため目を通すべきか判断つかないやつ」。

ここから「読むべき7通」を選り分けて、優先順位をつけて、返信の下書きを頭の中で組み立てる。気がつくと、もう8時を回っている。

これを Claude Code に肩代わりさせて、毎朝の 30分→3分まで圧縮した実装の記録です。

具体的に何が動いているのか。

- Gmail API で「直近24時間の未読」を取得する

- 本文を整形して Claude API に投げる

- 「要対応」「参考」「ノイズ」の3カテゴリに仕分ける

- 「要対応」だけ要約と返信ドラフトを生成

- 結果を朝7時に Slack DM か Gmail 下書きに配信

Gmail の受信箱を直接いじりません。新しい場所（Slack DM か Gmail の下書き）に答えだけが届く設計です。

こんな状態で詰まっていませんか

ターミナルが触れて、毎朝のメール処理に消耗しているあなたに聞きます。

- 朝のメール確認に毎日30分以上溶けている

- プロモーションとニュースレターに埋もれて、大事なメールを見落とす

- 「とりあえず全部既読」を押してしまい、後から「返信してませんでしたっけ？」と催促される

- Gmail のフィルタを作り込んでも、文面ベースの優先度判定までは無理

- AI メール整理 SaaS を試したが、月額が高いか、自分の業務観点に合わせられない

- Gmail API を触りたいけど、OAuth まわりの具体的な実装が見つからない

- Claude API を業務で使い始めたいが、最初の「自分のための1個」が決められない

3つ以上当てはまるなら、この実装書はあなた向けです。

なぜ今、Gmail 処理を自前で組むのか

ChatGPT・Claude を「仕事の相談相手」として使う段階は、もう終わりに近づいています。

次のステップは、自分のメールを、自分の業務観点で、自分のタイミングで処理するところまで踏み込むこと。ここを Claude Code に半分肩代わりさせると、毎朝の30分が3分に変わります。

なぜ Gmail を狙うのか。

理由は3つあります。

1つ目。Gmail は世界で最も普及しているメールクライアントで、API も公式が用意している。OAuth2 と REST API という枯れた組み合わせなので、Claude Code に設計を相談しながら進めやすい。

2つ目。メール処理は「やる必要があるのに気乗りしない」業務の代表格で、自動化したときの体感メリットが大きい。3日目には「もう手で確認するのが信じられない」状態になります。

3つ目。Gmail API を一度自分の手で握れると、「重要顧客からのメール検知」「請求書PDFの自動仕分け」「特定キーワードのアラート」など、派生する自動化が一気に作れるようになる。Gmail 処理は、業務自動化の入口として最もコストパフォーマンスが良い題材です。

SaaS の AI メール整理ツールは月¥1,800〜¥4,500。1年で¥21,600〜¥54,000。それに対して、自前実装の API コストは Claude 経由で月¥80〜¥200 に収まる。実機で1ヶ月測った数字です。

しかも自前なら、仕分け観点（重要度判定の基準、出力フォーマット、配信先のチャンネル）を自分の業務に合わせてチューニングできます。

ぼくが Gmail 処理に振り切った理由

これは盛らずに書きます。

ぼくは個人事業主で、複数のクライアントを並行で受けています。Gmail のラベルは20個以上、未読は週末を挟むと200通近くなる。月曜の朝、コーヒーを片手に Gmail を開いた瞬間に、その日の集中力の半分が消えていく感覚がありました。

> ※ ここに、月曜朝に200通近く溜まったGmail受信箱のスクショを差し込む予定です

「メールを読む」のが先頭タスクになる日が週に何度もあって、これは流石にどうにかしないと、と思ったのが2025年の春。

最初に試したのは ChatGPT の Custom GPT に Gmail のエクスポート（mbox）を貼り付ける方式。これは動くけど、毎朝エクスポートする時点で続かない。

次に既製の SaaS を試しました。月¥3,800のもの。動くけど、「重要度の自動判定」が緩くて、結局自分の目で再確認することになる。何より、自分のクライアントごとの優先順位（A社は即返信・B社は午後でOK）まで反映できない。

「自分の業務観点で仕分けできないと、結局二度手間になる」と気づいてから、Claude Code を本気で触り始めました。Gmail API のドキュメントを Claude に読ませて、必要なスコープを洗い出し、手元で動かす。それから cron に乗せ、最後に GitHub Actions に移す。

> ※ ここに、Claude CodeでGmail APIの実装を相談している作業画面のスクショを差し込む予定です

ここまで、初稿が動くまで5日、運用が安定するまで2週間。動き始めてからの3ヶ月で、朝のメール処理は 30分→3分に落ち着きました。

実装が安定するまでに踏んだ落とし穴は、後の章に全部書きます。

> ※ ここに、運用開始後にSlack DMで届いた「今日要対応のメール3件」の要約画面のスクショを差し込む予定です

教材の章立て

全5章 + Day 0/1/2 の段階ロードマップで構成しています。

「最小の動く仕分け → 配信を自動化 → クラウド運用化」の3段階。Day 1 で「とりあえず1回手元で仕分けが動く」体験を取ってから、Day 2 で自動配信に進みます。

Day 0（章1）: 全体像と最短ルート — 5つの構成要素、必要な API キー、Google Cloud のアプリ登録手順

Day 1（章2）: Gmail API で未読を取得する — OAuth2 同意フロー・refresh token の永続化・スコープ最小設計・gmail.users.messages.list / get の使い分け

Day 1（章3）: Claude に渡して仕分けと要約を作る — メール本文の整形（署名・引用の除去）・プロンプト設計・3カテゴリ整理・出力 JSON のスキーマ・コスト見積もり

Day 2（章4）: 朝7時に自動配信する — cron / GitHub Actions の使い分け・失敗時の通知・Slack DM 配信 / Gmail 下書き生成

必読（章5）: 落とし穴チェックリスト10選 + コスト試算 — refresh token の期限切れ・rate limit・PII の Claude 送信ルール・要約品質の劣化監視

各章末に、その章だけで動く状態に持っていくためのチェックリストがあります。

この記事に含まれるもの

実体のあるものだけを並べます。

- Google Cloud のアプリ作成手順（スコープ最小設計付き）

- OAuth2 同意フローと refresh token の永続化スクリプト

- gmail.users.messages.list と get の使い分けの判断軸

- メール本文の整形ユーティリティ（署名・引用・HTMLタグ除去）

- Claude へのプロンプトテンプレート（3カテゴリ仕分け + 要約 + 返信ドラフト）

- cron / GitHub Actions 両対応の運用スクリプト

- 落とし穴チェックリスト10項目

- コスト試算（月運用コストの実測値）

対象者・非対象者

対象者

- ターミナル・git・Node.js を触れる

- Gmail を業務で使っている（個人用でも可）

- 朝のメール処理時間を圧縮したい

- Claude Code を入れている、または入れる予定

- OAuth2 という単語を聞いて「あれね」とまでは思える

非対象者

- ターミナルを触ったことがない

- 「ボタン1つで終わる SaaS」を探している

- コードを自分で書く気がない（コピペ専門）

- 会社の Gmail（Google Workspace）の管理権限が一切ない人（個人 Gmail なら不要）

ざっくりコスト感

Claude API のコストは1回あたり ¥3〜10（軽量モデルで未読が50件のとき）。月20営業日で ¥60〜200/月。

Gmail API は無料。GitHub Actions は無料枠内。

合計で月¥300未満で回ります。

SaaS の AI メール整理ツールの月額（¥1,800〜¥4,500）と比べて大幅に安く、自分の業務観点に合わせて仕分け基準を変えられる位置づけです。

今だけの価格設定です

売れた数に応じて段階的に価格が上がる仕組みにしています。スクリーンショットを撮っておいて、価格が止まっているか確認してみてください。

| 段階 | 累計部数 | 価格 |

|---|---|---|

| 第1段階（今ここ） | 〜10部 | ¥980 |

| 第2段階 | 〜20部 | ¥1,980 |

| 第3段階 | 〜40部 | ¥2,980 |

| 第4段階 | 〜70部 | ¥4,980 |

| 第5段階（最終） | 71部〜 | ¥6,980 |

10部単位で値上げします。最終価格は¥6,980。今すぐ判断するか、後で¥6,000上乗せして買うかの差です。

「迷う時間」がそのまま値上げのカウントダウンになります。

読んでくれてありがとう

ここまで読んでくれてありがとうございます。

毎朝の Gmail 確認で30分が溶けていく感覚は、ぼく自身がいちばん消耗したところだったので、同じ消耗を踏む人を1人でも減らせたらと思って書きました。

実装の全コードと落とし穴の解説は、ここから先でお届けします。

朝7時、コーヒーを淹れる前に「今日要対応のメール3件」だけが Slack DM に届く。手元の Gmail は閉じたまま、最初の集中タスクに入れる。

その感覚を、明日からのあなたの朝に。