local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
References a Discord community for updates on the evolving MCP protocol and community engagement.
Provides configuration instructions specific to macOS for the Claude Desktop integration.
Provides distribution of the agentmail-mcp package through the Python Package Index, allowing users to easily install the MCP server.
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 またはローカル ソース) からパッケージをインストールするだけです。
次に以下を実行します:
これにより、ローカル マシン上でサーバーが実行されます。
オプション1: Claude Desktopを使用する
Claude Desktop からサーバーと対話する場合は、次の手順に従ってください。
- 仮想環境をアクティブ化します。
- 以下の行を実行すると、Agentmail MCP サーバーパッケージの場所を確認できます。agentmail-mcp パッケージを仮想環境にインストールした場合、.venv/bin/ ディレクトリ内に存在するはずです。Claude Desktop の場合は、仮想環境にインストールすることが重要です。
- 返されたパスをコピーします。
claude_desktop_config.jsonファイルのcommandフィールドにパスを貼り付けます。- Claude Desktop を再起動します。
claude_desktop_config.jsonファイルは次のようになります。
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 を呼び出します。
ライセンス
ライセンス
MITライセンス - このプロジェクトはMITライセンスに基づいて配布されています。自己責任でご利用ください。
⸻
You must be authenticated.
Tools
AIエージェントにリアルタイムの受信トレイを提供します。エージェント/LLMは独立した受信トレイで送受信を行い、アクションを実行できます。Gmailとは異なり、AI向けに構築されています。agentmail.toをご覧ください。