クロード・ポスト

Claude を通じてシームレスなメール管理インターフェースを提供する、モデルコンテキストプロトコル（MCP）サーバーです。この統合により、Claude との自然言語による会話を通じてメールを直接処理できるようになり、メールの検索、閲覧、安全な送信などの機能もサポートされます。

機能とデモ

メールの検索と閲覧

• 📧 日付範囲とキーワードでメールを検索

• 📅 毎日のメール統計を表示

• 📝 スレッドサポートでメールの全文を読む

メールの作成と送信

• ✉️ CC受信者のサポート付きメール送信

• 🔒 TLSによる安全なメール処理

Related MCP server: IMAP MCP Server

前提条件

• Python 3.12以上

• Gmailアカウント（または他のメールプロバイダー）

• Gmail を使用している場合:

  • 二要素認証が有効

  • アプリ固有のパスワードが生成されました

• クロードデスクトップアプリケーション

設定

1. uvをインストールします:

   # MacOS/Linux
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Remember to restart your terminal after installation

2. プロジェクトのクローンを作成してセットアップします。

   # Clone the repository
   git clone https://github.com/ZilongXue/claude-post.git
   cd claude-post
   
   # Create and activate virtual environment
   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   
   # Install dependencies
   uv pip install -e .

3. プロジェクト ルートに.envファイルを作成します。

   EMAIL_ADDRESS=your.email@gmail.com
   EMAIL_PASSWORD=your-app-specific-password
   IMAP_SERVER=imap.gmail.com
   SMTP_SERVER=smtp.gmail.com
   SMTP_PORT=587

4. Claude デスクトップを設定します。

   まず、Claude for Desktopがインストールされていることを確認してください。最新バージョンはこちらからインストールできます。既にClaude for Desktopをお持ちの場合は、最新バージョンにアップデートされていることを確認してください。

   Claude Desktop 構成ファイルを開きます。

   # MacOS
   ~/Library/Application Support/Claude/claude_desktop_config.json
   
   # Create the file if it doesn't exist
   mkdir -p ~/Library/Application\ Support/Claude
   touch ~/Library/Application\ Support/Claude/claude_desktop_config.json

   次の構成を追加します。

   {
     "mcpServers": {
       "email": {
         "command": "/Users/username/.local/bin/uv",
         "args": [
           "--directory",
           "/path/to/claude-post/src/email_client",
           "run",
           "email-client"
         ]
       }
     }
   }

   /Users/usernameと/path/to/claude-post実際のパスに置き換えます。

   設定を更新した後、変更を有効にするために Claude Desktop を再起動します。

サーバーの実行

サーバーはClaude Desktopを通じて自動的に実行されます。

• 正しく設定されていれば、Claude の起動時にサーバーが起動します。

• 手動によるサーバー管理は不要

• クロードが閉じられるとサーバーが停止します

クロードを通じての使用

自然言語コマンドを使ってメールを操作できます。以下に例をいくつか示します。

メールを検索

• 「先週のメールを表示」

• 「件名に「会議」が含まれるメールを検索」

• 「2024年1月1日から2024年1月7日までのrecruiting@linkedin.comからのメールを検索」

• 「先月送信したメールを検索」

メールの内容を読む

• 「メール #12345 の内容を見せてください」

• 「人事部からの最後のメールの全文は何ですか？」

メール統計

• 「今日は何通のメールを受け取りましたか？」

• 「過去1週間の毎日のメール数を表示」

メールを送信する

• 「 john@example.comにメールを送信したい」

• 「会議の確認をteam@company.comに送信してください」

注: セキュリティ上の理由から、Claude は実際にメールを送信する前に、必ず確認のためにメールの詳細を表示します。

プロジェクト構造

claude-post/
├── pyproject.toml
├── README.md
├── LICENSE
├── .env                    # Not included in repo
├── .python-version        # Python version specification
└── src/
    └── email_client/
        ├── __init__.py
        ├── __main__.py
        └── server.py       # Main implementation

セキュリティノート

• メインアカウントのパスワードの代わりにアプリ固有のパスワードを使用する

• Gmail ユーザーの場合:

  1. Googleアカウントで2段階認証を有効にする

  2. このアプリケーションのアプリパスワードを生成する

  3. .envファイルでアプリパスワードを使用する

ログ記録

アプリケーションはemail_client.logに詳細情報を記録します。デバッグ情報やエラーメッセージについては、このファイルを確認してください。

ライセンス

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