IMAP MCP サーバー

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

概要

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

メールの閲覧と検索
メールの整理（移動、タグ付け、マーク付け）
メールの作成と返信
インタラクティブな電子メール処理とユーザー設定の学習
自動メール要約と分類
複数のIMAPプロバイダーのサポート

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

特徴

メール認証: さまざまな認証方法による IMAP サーバーへの安全なアクセス
メール閲覧: フィルタリングオプションを使用してフォルダとメッセージを一覧表示します
メールの内容: テキスト、HTML、添付ファイルを含むメッセージの内容を読む
メールアクション: 移動、削除、既読/未読としてマーク、メッセージにフラグを付ける
メール作成: 適切な形式でメッセージへの返信を下書きして保存します
- プレーンテキストとHTMLの返信をサポート
- CC サポートによる全員返信機能
- In-Reply-To と References ヘッダーを使用した適切なスレッド化
- 下書きを適切なフォルダに保存する
検索: フォルダ間の基本的な検索機能
インタラクションパターン：電子メールの処理と学習設定のための構造化パターン（計画中）
学習レイヤー: ユーザーの意思決定を記録・分析し、将来の行動を予測する（計画）

現在のプロジェクト構造

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

.
├── examples/              # Example configurations
│   └── config.yaml.example
├── imap_mcp/              # Source code
│   ├── __init__.py
│   ├── config.py          # Configuration handling
│   ├── imap_client.py     # IMAP client implementation
│   ├── models.py          # Data models
│   ├── resources.py       # MCP resources implementation
│   ├── server.py          # Main server implementation
│   └── tools.py           # MCP tools implementation
├── tests/                 # Test suite
│   ├── __init__.py
│   └── test_models.py
├── INSTALLATION.md        # Detailed installation guide
├── pyproject.toml         # Project configuration
└── README.md              # This file

はじめる

前提条件

Python 3.8以上
IMAP 対応のメールアカウント（Gmail を推奨）
パッケージ管理とPythonスクリプトの実行のためのuv

インストール

まだインストールしていない場合は、uv をインストールします。
curl -LsSf https://astral.sh/uv/install.sh | sh
パッケージをクローンしてインストールします。
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の設定

設定ファイルを作成します。
cp config.sample.yaml config.yaml
Gmail OAuth2 認証情報を設定します。
- Google Cloud Consoleに移動
- 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください
- Gmail APIを有効にする
- OAuth2 認証情報を作成する (デスクトップアプリケーションタイプ)
- クライアント構成をダウンロードする
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

使用法

メールをチェック

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

uv run list_inbox.py --config config.yaml --folder INBOX --limit 10

利用可能なオプション:

--folder : チェックするフォルダを指定します（デフォルト: INBOX）
--limit : 表示するメールの最大数（デフォルト: 10）
--verbose : 詳細なログ出力を有効にする

MCPサーバーの起動

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

uv run imap_mcp.server --config config.yaml

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

uv run imap_mcp.server --dev

OAuth2トークンの管理

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

uv run imap_mcp.auth_setup refresh-token --config config.yaml

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

uv run imap_mcp.auth_setup generate-token --config config.yaml

発達

開発環境の設定

# Set up virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install development dependencies
pip install -e ".[dev]"

テストの実行

pytest

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

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

環境変数または安全な資格情報ストレージを使用して電子メール資格情報を安全に保存します
メインアカウントのパスワードの代わりにアプリ固有のパスワードの使用を検討してください
フォルダへのアクセスをユースケースに必要なものだけに制限する
メールプロバイダーの設定でサーバーに付与された権限を確認します

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

[x] プロジェクトの初期化とリポジトリのセットアップ
[x] 基本的なIMAP統合
[x] メールリソースの実装
[x] メールツールの実装
[x] メールの返信と下書き機能
[ ] ユーザー嗜好学習の実装
[ ] 高度な検索機能
[ ] 複数アカウントのサポート
[ ] 主要メールプロバイダーとの統合

貢献

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

ライセンス

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

謝辞

フレームワークを提供するためのモデルコンテキストプロトコル
クロードの発展のための人類学的
このプロジェクトを可能にするさまざまなPython IMAPライブラリ

IMAP MCP Server

Integrations