mcpField
G
gmail

gmail

github.com/team-attention生産性82838 回インストール27 週間前に更新
リポジトリ

gmail について

gmailは、Gmail APIを通じて複数のGoogleアカウントのメールを管理するスキルです。送信時は背景情報を集めて文案への意見を求め、テストメールの確認後に本送信します。

主な機能

  1. 01複数のGoogleアカウントを管理
  2. 02メールの読み取りと検索
  3. 03メール送信とラベル管理
  4. 04テスト送信と確認依頼
  5. 05期限切れトークンの自動更新

活用シーン

  1. 01未読メールや過去のやり取りの検索
  2. 02関連情報を基にしたメール文案の作成
  3. 03テストと確認後の宛先への送信

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/team-attention/plugins-for-claude-natives --skill gmail

インストール後、Claude Code で/gmailを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.gitignore
accounts.yaml.example
pyproject.toml
assets/
accounts.default.yaml
email-templates.md
signatures.md
references/
cli-usage.md
search-queries.md
setup-guide.md
scripts/
gmail_client.py
list_messages.py
manage_labels.py
read_message.py
send_message.py
setup_auth.py
scripts/core/
__init__.py
batch_processor.py
cache_manager.py
quota_manager.py
retry_handler.py

詳細

Gmail スキル

Gmail API を通じてメールを管理します。複数の Google アカウント間で、メールの閲覧、検索、送信、整理ができます。

アカウントの設定

コマンドを実行する前に、必ず accounts.yaml を読み込み、登録済みのアカウントを確認してください。

accounts.yaml がない、または空の場合 → 初期設定については references/setup-guide.md を読んでください

# accounts.yaml example
accounts:
  personal:
    email: [email protected]
    description: Personal Gmail
  work:
    email: [email protected]
    description: Work account

メール送信ワークフロー（5 ステップ）

メールを送信する際は、TaskCreate で 5 つのタスクを作成し、順番に実行してください。

ステップタスク主な操作
1背景情報の収集Explore SubAgents を並行して実行します：受信者情報、関連プロジェクト、背景情報
2過去の会話を確認--query "to:recipient OR from:recipient newer_than:90d" で検索 → AskUserQuestion でスレッドを選択
3メールを下書き下書きを作成 → AskUserQuestion でフィードバックを求める
4テスト送信ユーザー自身のアドレスに [TEST] メールを送信 → Gmail ウェブで開く → 確認を依頼
5実際に送信受信者に送信 → 完了を報告

署名：すべての送信メールの末尾に ---\nSent with Claude Code を追加してください

ワークフローの例：「John に会議のメールを送信」
1. Create 5 Tasks
2. Step 1: Run parallel Explore SubAgents
   - Search recipient (John) info (partners/, projects/, context.md, etc.)
   - Search meeting context (calendar, recent meeting notes, etc.)
3. Step 2: Search "to:[email protected] OR from:[email protected]"
   → If previous conversation exists, AskUserQuestion (reply/new email)
4. Step 3: Draft email → AskUserQuestion (proceed/revise)
5. Step 4: Test send to my email → Open in Gmail web (`open "https://mail.google.com/mail/u/0/#inbox/{message_id}"`) → Request confirmation
6. Step 5: Actual send → Done

CLI クイックリファレンス

# List messages
uv run python scripts/list_messages.py --account work --query "is:unread" --max 10

# Send email
uv run python scripts/send_message.py --account work --to "[email protected]" --subject "Subject" --body "Content"

# Check profile
uv run python scripts/manage_labels.py --account work profile

CLI の詳しい使い方：references/cli-usage.md 検索クエリのリファレンス：references/search-queries.md

ウェブでメールを表示

送信後、返された Message ID を使って Gmail ウェブで直接表示できます。

# URL format
https://mail.google.com/mail/u/0/#inbox/{message_id}

# Example: Open in browser after test send
open "https://mail.google.com/mail/u/0/#inbox/19c145bbd47ddd01"

注：u/0 は最初にログインしたアカウント、u/1 は 2 番目のアカウントです

ファイル構成

skills/gmail/
├── SKILL.md
├── accounts.yaml           # Account metadata
├── scripts/                # CLI scripts
├── references/
│   ├── setup-guide.md      # Initial setup guide
│   ├── cli-usage.md        # Detailed CLI usage
│   ├── search-queries.md   # Search query reference
│   └── credentials.json    # OAuth Client ID (gitignore)
├── assets/
│   ├── accounts.default.yaml  # Account config template
│   ├── email-templates.md     # Email body templates
│   └── signatures.md          # Signature templates (Plain/HTML)
└── accounts/               # Per-account tokens (gitignore)

エラー処理

状況解決方法
accounts.yaml がない初期設定については references/setup-guide.md を読んでください
トークンがないsetup_auth.py --account <name> を実行するようユーザーを案内してください
トークンの有効期限切れ自動更新します。失敗した場合は、再認証するよう案内してください

コメント

Markdown 対応