MCP Notmuch Sendmail

ステータス: 正常に動作し、既知のバグもなく毎日使用されています。

ステータス2: パッケージをPyPIに追加し、使用方法を更新しました。何か問題があればご報告ください :)

Claude をあなたのメールアシスタントにしましょう！MCP Notmuch Sendmail は Claude Desktop を notmuch メールデータベースに接続し、次のことを可能にします:

• メールスレッドを検索して閲覧する

• 会話をきれいなテキスト形式で表示する

• マークダウンを使用して新しいメールを作成する

• 引用されたコンテンツの重複をスマートに排除してスレッドに返信する

• LaTeX風のスタイルで美しいメールを作成

• 設定されたスクリプトを実行してメールデータベースを同期します

HTML メールのレンダリングには html2text を使用し、インライン画像を含むリッチ HTML メールの作成には markdown-it を使用します。

インストール

uv がインストールされていることを確認してください:

Related MCP server: iMessage MCP Server

Claude Desktopでの使用

claude_desktop_config.jsonに追加します:

環境変数

• NOTMUCH_DATABASE_PATH : notmuchデータベースへのパス（必須）

• NOTMUCH_REPLY_SEPARATORS : パイプで区切られたテキストマーカーのリスト - これらのマーカーのいずれかで始まる最初の行までメールの内容を保持し、引用された返信を削除します（必須）

• SENDMAIL_FROM_EMAIL : From:フィールドのメールアドレス（必須）

• SENDMAIL_EMAIL_SIGNATURE_HTML : メールに追加するHTML署名（オプション）

• NOTMUCH_SYNC_SCRIPT : メールを同期するためのスクリプトへのパス（オプション）

• LOG_FILE_PATH : ログファイルのパス（オプション）

• DRAFT_DIR : メールの下書きを保存するディレクトリ（オプション、デフォルトは /tmp/mcp-notmuch-sendmail）

API

ツール

• メールスレッドを探す

  • Notmuchデータベースでメールスレッドを探す

  • 入力: notmuch_search_query (文字列)

  • GXP3形式でタブ区切りのスレッドリストを返します。

• メールスレッドの表示

  • メールスレッドのすべてのメッセージを表示する

  • 入力: thread_id (文字列)

  • HTML->テキスト変換GXP4を使用して会話をテキスト形式で返します。

• 新しいメールを作成する

  • Markdownから新しいメールの下書きを作成します。SENDMAIL_EMAIL_SIGNATURE_HTMLが設定されている場合は、署名が自動的に追加されます。

  • 入力:

    • subject （文字列）：メールの件名

    • body_as_markdown (文字列): Markdown形式のメール本文

    • to （リスト）: 受信者のメールアドレス

    • cc （リスト、オプション）: CC受信者

    • bcc （リスト、オプション）: BCC受信者

  • ドラフトファイルを作成し、パスを返します: GXP5

• メールの返信を作成する

  • 既存のメールスレッドに返信を作成します。SENDMAIL_EMAIL_SIGNATURE_HTML が設定されている場合は、署名が自動的に追加されます。

  • 入力:

    • thread_id (文字列): 返信先のスレッドID

    • subject （文字列）：メールの件名

    • body_as_markdown (文字列): Markdown形式のメール本文

    • to （リスト）: 受信者のメールアドレス

    • cc （リスト、オプション）: CC受信者

    • bcc （リスト、オプション）: BCC受信者

  • ドラフトファイルを作成し、パスを返します: GXP6

• メールを送信

  • 作成したメールの下書きを送信する

  • 入力不要

  • 成功/エラーメッセージを返す

• 同期メール

  • 設定されたスクリプトを実行して電子メールを同期します

  • 入力不要

  • stdoutとstderrを含むスクリプトの出力を返します。

  • NOTMUCH_SYNC_SCRIPTが設定されている場合にのみ使用可能

返信セパレーター

NOTMUCH_REPLY_SEPARATORS環境変数は、メール返信の検出を制御します。スレッドを表示すると、各メールの内容は、設定された区切り文字で始まる最初の行で切り詰められます。これにより、新しい内容は保持されながら、引用符で囲まれた返信が削除されます。

さまざまな言語に推奨される区切りパターンは次のとおりです。

英語

ドイツ語

フランス語

オランダ語

イタリア語

注: パターンを区切るには | (パイプ) を使用してください。これらは一般的なメールクライアントから派生した簡略化されたパターンであるため、特定のニーズに合わせて調整する必要がある場合があります。

貢献

貢献は大歓迎です！バグ報告、機能リクエスト、ドキュメントの改善、コードへの貢献など、あらゆるご意見が貴重です。ぜひお気軽にご連絡ください。

• バグを報告したり機能を提案したりするには、問題を開いてください

• 改善点を記載したプルリクエストを送信する

• ドキュメントを充実させたり、使用例を共有したりする

• 質問をして経験を共有しましょう

目標は、Claude による電子メール管理をさらに改善することであり、あなたの洞察と貢献がその達成に役立ちます。

謝辞

このプロジェクトは、他者の優れた取り組みに基づいて構築されています。

• mail-parser-reply - 包括的なメール返信マーカーパターン

• notmuch - 高速メールインデックスと検索エンジン

• html2text - HTMLメールを読み取り可能なテキストに変換します

• markdown-it-py - 美しいHTMLメールを生成する

• latex.css - LaTeXスタイルの電子メールフォーマット用

ライセンス

Mozilla パブリックライセンス バージョン 2.0

私の他のLLMプロジェクト

• MCP Alchemy - スキーマを探索し、SQL を実行するために、Claude Desktop をデータベースに接続します。

• MCP Redmine - Claude Desktop で Redmine プロジェクトと問題を管理します。

• Diffpilot - ファイルのグループ化とタグ付けが可能な複数列の Git 差分ビューア。

• Claude ローカル ファイル- Claude デスクトップ アーティファクト内のローカル ファイルにアクセスします。