IMAP MCP サーバー

AI アシスタントが電子メールをチェックし、メッセージを処理し、対話を通じてユーザーの好みを学習できるようにするモデル コンテキスト プロトコル (MCP) サーバー。

概要

このプロジェクトは、IMAP 電子メール サーバーとインターフェイスして次の機能を提供する MCP サーバーを実装します。

• メールの閲覧と検索

• メールの整理（移動、タグ付け、マーク付け）

• メールの作成と返信

• インタラクティブな電子メール処理とユーザー設定の学習

• 自動メール要約と分類

• 複数のIMAPプロバイダーのサポート

IMAP MCP サーバーは、Claude やその他の MCP 互換アシスタントと連携するように設計されており、時間の経過とともにユーザーの好みを学習するインテリジェントな電子メール アシスタントとして機能します。

Related MCP server: Gmail MCP Server

特徴

• メール認証: さまざまな認証方法による IMAP サーバーへの安全なアクセス

• メール閲覧: フィルタリングオプションを使用してフォルダとメッセージを一覧表示します

• メールの内容: テキスト、HTML、添付ファイルを含むメッセージの内容を読む

• メールアクション: 移動、削除、既読/未読としてマーク、メッセージにフラグを付ける

• メール作成: 適切な形式でメッセージへの返信を下書きして保存します

  • プレーンテキストとHTMLの返信をサポート

  • CC サポートによる全員返信機能

  • In-Reply-To と References ヘッダーを使用した適切なスレッド化

  • 下書きを適切なフォルダに保存する

• 検索: フォルダ間の基本的な検索機能

• インタラクションパターン：電子メールの処理と学習設定のための構造化パターン（計画中）

• 学習レイヤー: ユーザーの意思決定を記録・分析し、将来の行動を予測する（計画）

現在のプロジェクト構造

プロジェクトは現在、次のように構成されています。

はじめる

前提条件

• Python 3.8以上

• IMAP 対応のメールアカウント（Gmail を推奨）

• パッケージ管理とPythonスクリプトの実行のためのuv

インストール

1. まだインストールしていない場合は、uv をインストールします。

   curl -LsSf https://astral.sh/uv/install.sh | sh

2. パッケージをクローンしてインストールします。

   git clone https://github.com/non-dirty/imap-mcp.git cd imap-mcp uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -e ".[dev]"

Gmailの設定

1. 設定ファイルを作成します。

   cp config.sample.yaml config.yaml

2. Gmail OAuth2 認証情報を設定します。

   • Google Cloud Consoleに移動

   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください

   • Gmail APIを有効にする

   • OAuth2 認証情報を作成する (デスクトップ アプリケーション タイプ)

   • クライアント構成をダウンロードする

3. Gmail の設定でconfig.yaml更新します。

   imap: host: imap.gmail.com port: 993 username: your-email@gmail.com use_ssl: true oauth2: client_id: YOUR_CLIENT_ID client_secret: YOUR_CLIENT_SECRET refresh_token: YOUR_REFRESH_TOKEN

使用法

メールをチェック

受信トレイ内のメールを一覧表示するには:

利用可能なオプション:

• --folder : チェックするフォルダを指定します（デフォルト: INBOX）

• --limit : 表示するメールの最大数（デフォルト: 10）

• --verbose : 詳細なログ出力を有効にする

MCPサーバーの起動

IMAP MCP サーバーを起動するには:

デバッグ付き開発モードの場合:

OAuth2トークンの管理

OAuth2 トークンを更新するには:

新しい OAuth2 トークンを生成するには:

発達

開発環境の設定

テストの実行

セキュリティに関する考慮事項

このMCPサーバーは、お客様のメールアカウントへのアクセスを必要とします。メールアカウントには、個人情報が含まれています。以下のセキュリティ上の考慮事項にご注意ください。

• 環境変数または安全な資格情報ストレージを使用して電子メール資格情報を安全に保存します

• メインアカウントのパスワードの代わりにアプリ固有のパスワードの使用を検討してください

• フォルダへのアクセスをユースケースに必要なものだけに制限する

• メールプロバイダーの設定でサーバーに付与された権限を確認します

プロジェクトロードマップ

• [x] プロジェクトの初期化とリポジトリのセットアップ

• [x] 基本的なIMAP統合

• [x] メールリソースの実装

• [x] メールツールの実装

• [x] メールの返信と下書き機能

• [ ] ユーザー嗜好学習の実装

• [ ] 高度な検索機能

• [ ] 複数アカウントのサポート

• [ ] 主要メールプロバイダーとの統合

貢献

貢献を歓迎します！ガイドラインについてはCONTRIBUTING.mdをご覧ください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

謝辞

• フレームワークを提供するためのモデルコンテキストプロトコル

• クロードの発展のための人類学的

• このプロジェクトを可能にするさまざまなPython IMAPライブラリ