FastMCP server for Apollo

Apollo.io MCP サーバー

Apollo.io REST API の全機能を Claude Code に提供する FastMCP サーバーです。シーケンス、キャンペーンの健全性、メールボックスのウォームアップ、人物／組織のエンリッチメント、CRM の連絡先、タスク、ラベル、クレジットの追跡に加え、テンプレート／シーケンス／メールボックスの上限をプログラムで編集する機能と監査ログを含む27個のツールを備えています。

既存の Apollo MCP の多くは、人物検索とエンリッチメントのみを提供します。このサーバーは、大規模なアウトバウンド営業を実施するチーム向けに構築されています。日次の健全性ダイジェスト、シーケンス管理、メールボックスの到達率モニタリング、連絡先のプログラムによる登録、Apollo の UI を操作せずにシーケンスをエンドツーエンドで作成できます。

クイックリファレンス

apollo_campaign_health                — daily digest (start here)
apollo_messages_search days_back=1    — raw send/open/reply/bounce log
apollo_mailbox_warmup                 — per-mailbox deliverability state
apollo_sequences_list                 — all sequences + labels + stats
apollo_sequence_add_contacts ...      — enroll contacts into a sequence
apollo_template_update ...            — update template body + subject (with audit log)
apollo_sequence_create ...            — author a new sequence end-to-end
apollo_step_create ...                — add a step + template to a sequence
apollo_mailbox_update_cap ...         — change daily send cap
apollo_credits_remaining              — monthly credit budget check
apollo_health                         — self-check (also probes master key)

ツール一覧（27個）

キャンペーンの健全性

• apollo_campaign_health(days_back=1) — すべてのシーケンスとメールボックスのダイジェスト
• apollo_mailbox_warmup() — メールボックスごとのウォームアップ状況と日次上限
• apollo_sequence_get(sequence_id) — 1つのシーケンスを詳細に確認

シーケンス

• apollo_sequences_list() — 統計情報付きですべてのシーケンスを一覧表示
• apollo_sequence_add_contacts(sequence_id, contact_ids, send_email_from_email_account_id?)
• apollo_sequence_remove_contacts(sequence_id, contact_ids)
• apollo_sequence_set_active(sequence_id, active) — 有効化または一時停止

メッセージ／分析

• apollo_messages_search(days_back, sequence_ids?, stats?, per_page, max_pages)

人物／組織

• apollo_people_search(...) — 無料（クレジットを消費しません）
• apollo_person_enrich(...) — メールアドレスを1件開示するごとに1クレジット
• apollo_bulk_person_enrich(people, reveal_personal_emails?) — 1回の呼び出しで最大10件
• apollo_org_search(...)
• apollo_org_enrich(domain)
• apollo_org_job_postings(organization_id)

CRM

• apollo_contacts_search(...)
• apollo_contact_create(...)
• apollo_contact_update(contact_id, fields)
• apollo_contact_stages()

タスク／ラベル／クレジット

• apollo_task_create(...)
• apollo_labels_list()
• apollo_label_create(name)
• apollo_credits_remaining()

テンプレートとシーケンスの作成・編集（破壊的な書き込み）

• apollo_template_get(template_id) — 現在のテンプレートの状態を取得
• apollo_template_update(template_id, subject?, body_text?, body_html?, audit_label?) — テンプレートの件名と本文を更新します。書き込みの前に、現在の状態を APOLLO_AUDIT_LOG_PATH（設定されている場合）に保存するため、問題が発生しても差分から元に戻せます
• apollo_sequence_create(name, label?, permissions?, active?) — 新しいシーケンスを作成します（デフォルトでは一時停止状態）
• apollo_step_create(sequence_id, position, wait_days, subject, body_text, body_html?, step_type?, include_signature?) — 1回の呼び出しでステップ、タッチ、テンプレートを作成します
• apollo_mailbox_update_cap(mailbox_id, daily_send_limit, audit_label?) — メールボックスの日次送信上限を変更します。変更前後を監査します

診断

• apollo_health() — API キーの有効性とマスターキーのヒントを確認します

設定

config.example.yaml を config.yaml にコピーし、値を入力します。

cp config.example.yaml config.yaml

config.yaml は gitignore に登録されています。主なフィールドは次のとおりです。

環境変数：

インストール

Claude Code を開き、次のコマンドを貼り付けます。

/plugin marketplace add adelaidasofia/apollo-mcp
/plugin install apollo-mcp@apollo-mcp

次に、環境変数に APOLLO_API_KEY（master キーである必要があります）を設定し、Claude Code を再起動します。

pip3 install -r requirements.txt
python3 -c "import server; print('OK')"

{
  "mcpServers": {
    "apollo": {
      "command": "python3",
      "args": ["/path/to/apollo-mcp/server.py"],
      "env": {
        "APOLLO_API_KEY": "your-master-key-here"
      }
    }
  }
}

既知の注意点

1. /emailer_campaigns、/emailer_messages/search、/email_accounts、/usage_stats/* には MASTER キーが必要です。標準キーでは 403 が返されます。apollo_health はこれを自動的に検査します。

2. レート制限は約 60 リクエスト/分です。ジッター付きの指数バックオフが組み込まれており、429 を透過的に処理します。

3. ページネーションは、1 回の呼び出しにつき最大 50 ページ × 100 件/ページ = 5,000 件に制限されています。さらに深く検索する場合は、日付で範囲を絞ってください。

4. クレジット消費 — apollo_person_enrich(reveal_personal_emails=True) と一括処理版は、それぞれ 1 クレジットを消費します。

5. sequences_list、email_accounts、labels、contact_stages は、メモリ内に 5 分間キャッシュされます。強制的に更新するには、Claude Code を再起動してください。

6. デフォルトの Python UA では Cloudflare 1010 が発生します。 apollo.io は、python-urllib/* または python-httpx/* のユーザーエージェントを検出すると、本文が error code: 1010 の HTTP 403 を返します。このサーバーは apollo-mcp/1.0 (curl/8.0.0) を偽装して回避します。apollo.io にアクセスする関連スクリプトを作成する場合は、同じ User-Agent ヘッダーを追加してください。そうしないと、master キーが不足しているように見える原因不明の 403 の調査に時間を取られます。

7. シーケンス単位で登録解除できる、動作するエンドポイントはありません。 POST /emailer_campaigns/{id}/remove_contact_ids は 404 を返します。ID を指定しない POST /emailer_campaigns/remove_contact_ids は 200 を返しますが、ペイロードに関係なく何も行いません。確実に登録解除する方法は DELETE /contacts/{id} のみで、すべてのキャンペーンへの登録が連鎖的に解除されます。破壊的な操作であり、コンタクトレコードには deleted: true が設定されます。apollo_sequence_remove_contacts はこの処理をラップします。

8. GET /emailer_campaigns は空のシーケンスを作成します。 シーケンスの一覧表示には POST /emailer_campaigns/search を使用してください。サーバーは適切に処理しますが、API を直接呼び出す場合は注意してください。

9. シーケンスの有効化にはサブリソースではなく PUT を使用します。 シーケンスを有効化または一時停止する正しいエンドポイントは、本文 {"emailer_campaign": {"active": true/false}} を指定した PUT /emailer_campaigns/{id} です。/check_contacts のようなサブリソースパスは 404 を返します。

スクリプト

• scripts/daily_digest.py — 前日の統計を取得し、Markdown ダッシュボードの先頭に追加するスタンドアロンスクリプトです。cron または手動で実行します。
• scripts/bootstrap_sequences.py — コードからプログラムでシーケンスを作成します。メール文面のバージョン管理に便利です。ステップを下書き状態から移行するために必要な、ドキュメント化されていない POST /emailer_touches/{id}/approve エンドポイントも使用します。

関連する MCP

同じ作者、同じアーキテクチャパターン（FastMCP、該当する書き込み操作ではドラフト＋確認、Vault の自動エクスポート、MIT）：

• slack-mcp — 複数ワークスペースの Slack
• imessage-mcp — macOS の iMessage
• whatsapp-mcp — whatsmeow 経由の WhatsApp
• google-workspace-mcp — Gmail / Calendar / Drive / Docs / Sheets
• substack-mcp — Substack の記事作成＋分析
• luma-mcp — lu.ma のイベント
• parse-mcp — markitdown / Docling / LlamaParse のルーター
• rescuetime-mcp — RescueTime の生産性データ
• graph-query-mcp — Vault のナレッジグラフクエリ
• graph-autotagger-mcp — グラフからのウィキリンク候補
• investor-relations-mcp — シード資金調達パイプラインのトラッカー
• vault-sync-mcp — 双方向の Vault 同期

テレメトリー

このプラグインは、特定のマシンで Claude Code セッション中に初めて読み込まれたとき、匿名のインストールシグナルを 1 回だけ myceliumai.co に送信します。

送信される情報：

• プラグイン名（例：slack-mcp）
• プラグインのバージョン（例：0.1.0）

送信されない情報：

• ユーザー識別情報、名前、メールアドレス、トークン、API キーは送信されません
• ファイルパス、メッセージ内容、作業に関する情報は送信されません
• 重複排除処理後、IP アドレスは保存されません

目的： メンテナーが実際にインストールされているプラグインを把握し、利用されているプラグインに注力できるようにします。

オプトアウト： Claude Code の起動前に環境変数 MYCELIUM_NO_PING=1 を設定してください。フックはネットワーク呼び出しを完全にスキップします。すでにシグナルを送信したインストールでは ~/.mycelium/onboarded-<plugin> にセンチネルファイルが作成されます。状態をリセットしたい場合は、このファイルを削除してください。

ライセンス

MIT

Mycelium AI が開発しました。完全版またはチーム版は diazroa.com をご覧ください。