Claude Code x Gmail API でメールフィルター・自動仕分けを完全自動化する

毎朝50通のメール仕分けが0秒になった

営業サポートの吉田です。毎朝出社してまず50通のメールを開封・仕分けするのに30分かかっていました。請求書・見積依頼・問い合わせ・メルマガ……Claude CodeでGmail APIを使ったルールベース自動仕分けと優先度判定を実装し、受信トレイが常にクリーンになりました。

STEP 1：Gmail APIでメールを自動取得・分類する

Gmail APIを使って受信メールを取得し、ルールベースで自動分類します。

from google.oauth2.credentials import Credentials
from googleapiclient.discovery import build
import base64, re

def get_gmail_service():
    creds = Credentials.from_authorized_user_file("token.json")
    return build("gmail","v1",credentials=creds)

def fetch_unread_emails(service, max_results=50):
    results = service.users().messages().list(
        userId="me", q="is:unread", maxResults=max_results).execute()
    messages = results.get("messages", [])
    emails = []
    for msg in messages:
        detail = service.users().messages().get(
            userId="me", id=msg["id"], format="full").execute()
        headers = {h["name"]: h["value"] for h in detail["payload"]["headers"]}
        body = ""
        if "parts" in detail["payload"]:
            for part in detail["payload"]["parts"]:
                if part["mimeType"] == "text/plain":
                    body = base64.urlsafe_b64decode(part["body"].get("data","")).decode("utf-8", errors="ignore")
                    break
        emails.append({"id": msg["id"], "from": headers.get("From",""),
                        "subject": headers.get("Subject",""), "body": body[:500]})
    return emails

RULES = [
    {"category": "請求書",    "keywords": ["請求書","invoice","ご請求","領収書"]},
    {"category": "見積依頼",  "keywords": ["見積","お見積","estimate","価格"]},
    {"category": "お問い合わせ","keywords": ["お問い合わせ","ご質問","contact","inquiry"]},
    {"category": "社内連絡",  "domains":  ["company.com","our-domain.co.jp"]},
    {"category": "メルマガ",  "keywords": ["配信停止","unsubscribe","メールマガジン","newsletter"]},
]

def classify_email(email):
    text = (email["subject"] + " " + email["body"]).lower()
    sender = email["from"].lower()
    for rule in RULES:
        if any(kw.lower() in text for kw in rule.get("keywords",[])):
            return rule["category"]
        if any(domain in sender for domain in rule.get("domains",[])):
            return rule["category"]
    return "その他"

service = get_gmail_service()
emails  = fetch_unread_emails(service)
for email in emails:
    email["category"] = classify_email(email)
    print(f"[{email['category']}] {email['subject'][:40]}")

STEP 2：分類に応じてGmailラベルを自動付与する

分類結果に基づいてGmailのラベルを自動で付与し、フォルダ分けします。

def get_or_create_label(service, label_name):
    labels = service.users().labels().list(userId="me").execute().get("labels",[])
    for label in labels:
        if label["name"] == label_name: return label["id"]
    # ラベルを新規作成
    body = {"name": label_name, "messageListVisibility": "show",
            "labelListVisibility": "labelShow"}
    new_label = service.users().labels().create(userId="me", body=body).execute()
    print(f"ラベル作成: {label_name}")
    return new_label["id"]

LABEL_COLORS = {
    "請求書":     {"backgroundColor": "#fb4c2f", "textColor": "#ffffff"},
    "見積依頼":   {"backgroundColor": "#ffad47", "textColor": "#000000"},
    "お問い合わせ":{"backgroundColor": "#16a766", "textColor": "#ffffff"},
    "社内連絡":   {"backgroundColor": "#4986e7", "textColor": "#ffffff"},
    "メルマガ":   {"backgroundColor": "#999999", "textColor": "#ffffff"},
}

label_id_cache = {}
for email in emails:
    cat = email["category"]
    if cat not in label_id_cache:
        label_id_cache[cat] = get_or_create_label(service, f"AI仕分/{cat}")
    
    service.users().messages().modify(
        userId="me", id=email["id"],
        body={"addLabelIds": [label_id_cache[cat]]}
    ).execute()
    print(f"ラベル付与: [{cat}] {email['subject'][:30]}")

STEP 3：メルマガを自動アーカイブして受信トレイをゼロに保つ

メルマガと判定されたメールを自動でアーカイブし、受信トレイをクリーンに保ちます。

from datetime import datetime, timedelta

def auto_archive_newsletters(service, emails):
    newsletter_ids = [e["id"] for e in emails if e["category"] == "メルマガ"]
    if not newsletter_ids: return
    
    # 一括アーカイブ（INBOXラベルを削除）
    service.users().messages().batchModify(
        userId="me",
        body={"ids": newsletter_ids, "removeLabelIds": ["INBOX"]}
    ).execute()
    print(f"メルマガ {len(newsletter_ids)}件をアーカイブ")

def delete_old_newsletters(service, days=3):
    cutoff = (datetime.now() - timedelta(days=days)).strftime("%Y/%m/%d")
    results = service.users().messages().list(
        userId="me",
        q=f"label:AI仕分/メルマガ before:{cutoff}"
    ).execute()
    old_msgs = results.get("messages",[])
    
    for msg in old_msgs:
        service.users().messages().trash(userId="me", id=msg["id"]).execute()
    
    print(f"{days}日以上前のメルマガ {len(old_msgs)}件を削除")

auto_archive_newsletters(service, emails)
delete_old_newsletters(service, days=3)

STEP 4：重要メールをSlackに自動通知する

請求書・見積依頼などの重要メールをSlackチャンネルに自動通知します。

import requests

SLACK_WEBHOOKS = {
    "請求書":     "https://hooks.slack.com/services/BILLS/CHANNEL/URL",
    "見積依頼":   "https://hooks.slack.com/services/QUOTE/CHANNEL/URL",
    "お問い合わせ":"https://hooks.slack.com/services/INQUIRY/CHANNEL/URL",
}

def notify_slack(email, category):
    webhook = SLACK_WEBHOOKS.get(category)
    if not webhook: return
    
    message = {
        "blocks": [
            {"type": "header",
             "text": {"type": "plain_text", "text": f"📧 {category}が届きました"}},
            {"type": "section",
             "fields": [
                {"type": "mrkdwn", "text": f"*送信者:*
{email['from']}"},
                {"type": "mrkdwn", "text": f"*件名:*
{email['subject']}"},
                {"type": "mrkdwn", "text": f"*本文（抜粋）:*
{email['body'][:100]}..."},
             ]},
            {"type": "actions",
             "elements": [
                {"type": "button", "text": {"type":"plain_text","text":"Gmailで開く"},
                 "url": f"https://mail.google.com/mail/#inbox/{email['id']}"}
             ]}
        ]
    }
    requests.post(webhook, json=message)

for email in emails:
    if email["category"] in SLACK_WEBHOOKS:
        notify_slack(email, email["category"])
        print(f"Slack通知: [{email['category']}] {email['subject'][:40]}")

STEP 5：毎朝自動実行でメール管理を完全自動化する

毎朝8時に自動実行し、出社前にメールの仕分けが完了している状態を作ります。

import schedule, time

SUMMARY_WEBHOOK = "https://hooks.slack.com/services/SUMMARY/WEBHOOK/URL"

def morning_email_routine():
    print("📧 朝のメール自動仕分け開始")
    service  = get_gmail_service()
    emails   = fetch_unread_emails(service, max_results=100)
    for e in emails: e["category"] = classify_email(e)
    
    # ラベル付与・アーカイブ
    for email in emails:
        apply_label(service, email)
    auto_archive_newsletters(service, emails)
    delete_old_newsletters(service, days=3)
    
    # カテゴリ別集計
    from collections import Counter
    cat_count = Counter(e["category"] for e in emails)
    
    # サマリーをSlackに通知
    summary_text = "
".join([f"• {cat}: {cnt}件" for cat, cnt in cat_count.most_common()])
    requests.post(SUMMARY_WEBHOOK, json={"blocks":[
        {"type":"header","text":{"type":"plain_text","text":"☀️ 朝のメール仕分け完了"}},
        {"type":"section","text":{"type":"mrkdwn",
         "text": f"*未読{len(emails)}件を自動処理しました*
{summary_text}"}}
    ]})
    print(f"完了: {len(emails)}件処理")

schedule.every().day.at("08:00").do(morning_email_routine)
while True: schedule.run_pending(); time.sleep(60)

制作実績サンプル

このクオリティの資料が、あなたの業務でも作れます

Aurant Technologies が実際に制作したコンサルティング資料（全82枚）のサンプルです。Claude Code × AI自動化により、従来の1/5のコスト・時間で同等品質を実現します。

タイトル・ダーク背景

3カラム比較・分析

AI活用フロー図解

Before/After比較

構造化コンテンツ

→

全10枚を
見る

御社のテーマでこのレベルの資料を作成できます

制作費・納期・自動化プランは無料相談でご確認いただけます

📊 サンプル全10枚を見る →