AgentMail MCP 統合

AgentMailと統合されたシンプルな**モデルコンテキストプロトコル（MCP）**サーバー。ClaudeなどのAIアシスタントを介して、メール受信トレイの動的な管理、メッセージの一覧表示、メールの送信や返信などを行うことができます。このリファレンス実装は、MCPサーバー内でAgentMailのAPIを使用して、メール受信トレイをリアルタイムにオーケストレーションする方法を示しています。

エージェントメールについて

AgentMailは、APIファーストのメールプロバイダーです。AIエージェントがリアルタイムで受信トレイを作成し、メールの送受信やアクションを実行できます。メールレイヤー上には、エージェントワークフローに最適化され、LLMで処理可能なデータを提供するインテリジェンスレイヤーが構築されています。APIキーはこちらからリクエストできます。

重要な注意事項

MCPプロトコルはまだ進化しているため、このパッケージは現在開発中です。新機能が追加され次第、更新いたします。Discordに参加してコミュニティにご参加ください！ Discord

特徴

新しい受信トレイを動的に作成する
**受信トレイを一覧表示して取得し、**アクティブなものを確認します
AgentMailの受信トレイからメールを送信する
既存のスレッド内のメッセージに返信する
選択した受信トレイのスレッドとメッセージを一覧表示する
メッセージの添付ファイルを取得する

前提条件

Python 3.10以上
エージェントメールAPIキー
(オプション) Claude Desktopまたは MCP コマンドをサポートするその他のフロントエンド

インストール

このプロジェクト用のPyPiパッケージが存在します。インストール後、Claude Desktopの設定で参照（または直接実行）して、メール管理ツールを有効にできます。

PIP (ローカルまたはPyPI)

独自の Python 環境を維持する場合は、仮想環境 (PyPI またはローカルソース) からパッケージをインストールするだけです。

pip install agentmail-mcp

次に以下を実行します:

agentmail-mcp --api-key="YOUR_AGENTMAIL_API_KEY"

これにより、ローカルマシン上でサーバーが実行されます。

オプション1: Claude Desktopを使用する

Claude Desktop からサーバーと対話する場合は、次の手順に従ってください。

仮想環境をアクティブ化します。

source .venv/bin/activate

以下の行を実行すると、Agentmail MCP サーバーパッケージの場所を確認できます。agentmail-mcp パッケージを仮想環境にインストールした場合、.venv/bin/ ディレクトリ内に存在するはずです。Claude Desktop の場合は、仮想環境にインストールすることが重要です。

which agentmail-mcp

返されたパスをコピーします。
claude_desktop_config.jsonファイルのcommandフィールドにパスを貼り付けます。
Claude Desktop を再起動します。

claude_desktop_config.jsonファイルは次のようになります。

{ "mcpServers": { "agentmail-mcp": { "command": "/path/to/agentmail-mcp", "args": ["--api-key", "{AGENT_MAIL_API_KEY}"] } } }

claude_desktop_config.jsonファイルがない場合は、次のディレクトリに作成します。

macOSでは、設定ファイルは通常次の場所にあります: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows では通常、次の場所にあります: %APPDATA%/Claude/claude_desktop_config.json

保存後、Claude Desktop を再起動して新しい MCP サーバーをロードします。

使用法

Claude Desktop（または他のMCPクライアント）でサーバーを実行している場合、AgentMail MCPツールにマッピングされた自然言語コマンドを使用してClaudeに指示を出すことができます。例：•「demoという名前の新しい受信トレイを作成してください。」•「すべての受信トレイを一覧表示してください。」•「受信トレイtest@agentmail.toからtest@example.comに、件名を「Hello」、本文にサンフランシスコの過去1週間の天気を記載したメールを送信してください。」•「受信トレイabc123の最新のメッセージに返信してください。」

内部的には、Claude は公開された MCP ツール (create_inbox、list_inboxes、send_message など) を呼び出し、これらのツールが AgentMail API を呼び出します。