Gmail受信トレイ管理
目標
統一ツールを使用して、複数のGmailアカウントのメールを確認・管理します。
スクリプト
./scripts/gmail_unified.py- 受信トレイの確認と管理./scripts/gmail_multi_auth.py- アカウントの認証./scripts/gmail_bulk_label.py- 一括ラベル付け./scripts/gmail_create_filters.py- フィルタの作成./scripts/gmail_auth.py- 認証ヘルパー
クイックリファレンス
# 全アカウントの未読メールを確認
python3 ./scripts/gmail_unified.py --query "is:unread" --limit 50
# 特定のアカウントのみ確認
python3 ./scripts/gmail_unified.py --query "is:unread" --account yourcompany
# 登録済みアカウントの一覧表示
python3 ./scripts/gmail_unified.py --accounts
# メールにラベルを付けてアーカイブ
python3 ./scripts/gmail_unified.py --query "from:notifications@" --label "Notifications" --archive
# 既読にする
python3 ./scripts/gmail_unified.py --query "from:noreply@" --mark-read
# ドライラン（プレビュー）
python3 ./scripts/gmail_unified.py --query "subject:invoice" --label "Invoices" --dry-run
アカウントレジストリ
| アカウント | メール | 認証情報 | トークン |
|---|---|---|---|
| youruser | [email protected] | credentials.json | token_youruser.json |
| yourcompany | [email protected] | credentials_yourcompany.json | token_yourcompany.json |
認証エラーのトラブルシューティング
「トークンファイルが見つかりません」
python3 ./scripts/gmail_multi_auth.py --account yourcompany --email [email protected]
「invalid_scope: Bad Request」
rm token_youruser.json
python3 ./scripts/gmail_multi_auth.py --account youruser --email [email protected]
「認証に失敗しました」 ルートディレクトリにcredentials.jsonが存在することを確認してください。
必要なスコープ
gmail.modify- メールの読み取り/書き込みgmail.labels- ラベルの作成/管理gmail.settings.basic- 設定の管理spreadsheets- Googleスプレッドシートへのアクセスdrive- Googleドライブへのアクセス
認証情報の場所
すべての認証情報ファイルはワークスペースルートに配置してください。
credentials.json/credentials_yourcompany.json- OAuthクライアント設定token_*.json- 認証トークン（自動生成）gmail_accounts.json- アカウントレジストリ
スキーマ
入力
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
query | string | いいえ | Gmail検索クエリ（例：'is:unread'） |
account | string | いいえ | レジストリ内の特定のアカウント名 |
limit | integer | いいえ | 取得する最大メール数（デフォルト：50） |
出力
| 名前 | 型 | 説明 |
|---|---|---|
emails | array | 件名、送信者、日付、スニペットを含むメールオブジェクトのリスト |
認証情報
| 名前 | ソース |
|---|---|
credentials.json | ファイル |
token_*.json | ファイル（自動生成） |
組み合わせ可能なスキル
このスキルと連携しやすいスキル：gmail-label、instantly-autoreply
コスト
無料（Gmail API）