Faivelo Email

Faivelo メール MCP サーバー

Claude、ChatGPT、Cursor、Codex、または任意の AI エージェントに、独自ドメインの実際のメール受信箱を利用させましょう。アシスタントはメールの閲覧と検索、返信の下書きと送信、送信予約、メッセージの整理、新しいアドレスの作成、ドメインの DNS の修正を行えます。アクセスできるメールボックスは、正確に指定できます。

次のような用途に便利です。

• コーディングエージェントに、作成したばかりのサイト用の [email protected] を設定させる
• AI エージェントに独自のアドレスを与え、サービスへの登録や認証コードの受信に使う
• Claude からサポート用受信箱の内容を振り分け、要約し、返信する
• メールアプリを開かずに、実際のアドレスから返信を送る

サーバー URL： https://faivelo.com/api/mcp（ストリーミング可能な HTTP、OAuth 2.1、貼り付ける API キーは不要） レジストリ名： com.faivelo/mail アクセス： Faivelo アカウントが必要です。MCP は Growth 以上のプランと、無料トライアル（カード不要）に含まれています。プラン

インストール

クライアント	コマンド 1 つ
Claude Code（プラグイン：MCP + スキル）	/plugin marketplace add ethannschwartz/faivelo-mcp の後に /plugin install faivelo@faivelo
Claude Code（MCP のみ）	claude mcp add --transport http faivelo https://faivelo.com/api/mcp
claude.ai / Claude Desktop	設定 → コネクター → カスタムコネクターを追加 → https://faivelo.com/api/mcp を貼り付け
Cursor（プラグイン：MCP + ルール + スキル）	エージェントのチャットで /add-plugin faivelo を実行するか、サーバー単体の場合はCursor に追加（Cursorを参照）
VS Code	VS Code にインストール
Codex	codex mcp add faivelo --url https://faivelo.com/api/mcp
Gemini CLI	gemini extensions install https://github.com/ethannschwartz/faivelo-mcp
Windsurf	mcp_config.json に { "mcpServers": { "faivelo": { "serverUrl": "https://faivelo.com/api/mcp" } } } を設定
Agent Skills 対応クライアント	npx skills add ethannschwartz/faivelo-mcp（faivelo-email スキル）
その他のクライアント	{ "mcpServers": { "faivelo": { "url": "https://faivelo.com/api/mcp" } } }

最初の呼び出しでブラウザーが開き、サインイン後、アシスタントがアクセスできるメールボックスを正確に指定できます。

ヘッドレスエージェント（ブラウザーなし）の場合は、代わりに API キーを送信します。 Authorization: Bearer fvl_live_...。設定 → 開発者でエージェントキーを作成してください。このキーでアクセスできるのは、エージェントが作成したメールボックス、またはアクセス権を付与されたメールボックスのみです。

Cursor

導入方法は 2 つあります。どちらも最初の呼び出し時にブラウザー経由でサインインするため、貼り付けるキーはありません。

• プラグイン（Cursor Marketplace に掲載された後）：エージェントのチャットで /add-plugin faivelo と入力するか、Settings → Plugins で Faivelo を探します。プラグインをインストールすると、MCP サーバー、faivelo-email スキル、およびエージェントにドメインでのメール設定、アプリからの送信、Webhook の検証方法を教えるルールが追加されます。
• サーバーのみ：Cursor に追加するか、{ "mcpServers": { "faivelo": { "url": "https://faivelo.com/api/mcp" } } } を .cursor/mcp.json（このプロジェクト）または ~/.cursor/mcp.json（すべてのプロジェクト）に追加します。 ヘッドレス環境で設定する場合は、"headers": { "Authorization": "Bearer fvl_live_..." } を追加します。

Cursor では、有効にしているすべての MCP サーバーからモデルに送信できるツールは最大約 40 個です。Faivelo は OAuth 接続では 30～34 個（API キー使用時は 38 個）のツールを公開するため、他のサーバーも併用する場合は、Cursor の MCP 設定で不要なツールを無効にしてください。通常は Drive ツール（drive_list_files、drive_download_file）とスケジュール管理ツール（list_scheduled、cancel_scheduled）が最初の候補です。

ツール

領域	ツール
読み取り	list_messages、read_message、get_thread、search_messages、search_all_mailboxes、list_folders、get_attachment、get_contacts
送信	send_message、send_batch（多数の宛先にテンプレートメールを 1 通ずつ送信。サーバー側でキューに登録し、送信間隔を調整します）、get_batch_status、create_draft、update_draft、send_draft、list_scheduled、cancel_scheduled、get_delivery_status
整理	flag_message、label_message、move_message、restore_message、mark_spam、mark_all_read、delete_message、empty_trash
アカウント	list_mailboxes、create_mailbox、update_mailbox（メールボックスから送信する際の名前を設定）、get_account_summary、get_setup_summary、get_domain_setup（ドメインの DNS レコードのうち、検出済みまたは未検出のもの）、list_aliases、create_alias、delete_alias
ドメインと DNS	list_domains、list_dns_records、create_dns_record、update_dns_record、delete_dns_record
Drive	drive_list_files、drive_download_file

send_message と send_batch では、from に "[email protected]" または "Support Bot <[email protected]>" を指定します。ここで名前を指定するか、fromName を使うと、そのメッセージだけに送信者名が設定されます。各メールボックスに永続的な名前を設定するには、create_mailbox の displayName または update_mailbox を使います。どこにも名前が設定されていないメールボックスから送信すると、その旨を示す hint が返されます。

get_setup_summary は、設定済みの内容（ドメイン、DNS の状態、メールボックス、未完了の項目）をまとめた共有可能な Markdown 形式の概要を返します。エージェントは作業完了時にこれを人間に渡せます。

すべてのツールで readOnlyHint / destructiveHint が宣言されているため、クライアントは送信や削除の前に確認を求めることができます。

このリポジトリの内容

• server.json：公式 MCP Registry のエントリー
• .claude-plugin/ + .mcp.json：Claude Code プラグインとそのマーケットプレイス
• .cursor-plugin/ + mcp.json + rules/：Cursor プラグイン（ルールはスキルから生成されます）
• skills/faivelo-email/：ドメインでのメール設定、アプリからの送信、受信 Webhook の検証方法をエージェントに教える Agent Skill
• gemini-extension.json + GEMINI.md：Gemini CLI 拡張機能
• assets/logo.svg：プラグインの掲載に使用する Faivelo のロゴ
• CHANGELOG.md：各プラグインバージョンでの変更内容

ドメインでメールをまだ使っていませんか？

npx faivelo init yourdomain.com

ドメインを接続し、DNS レコードを設定して（Vercel、Cloudflare、Netlify などの対応ホストでは自動設定）、メールボックスを作成します。プランはメールボックス数無制限で月額 $6 から。転送は無料です。

• ウェブサイト：https://faivelo.com/ai-agents?via=mcp
• ドキュメント：https://faivelo.com/docs/developers/connect-claude/?via=mcp
• Node SDK：npm install faivelo · Python SDK：pip install faivelo