MCP Notmuch Sendmail

MCP Notmuch Sendmail

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

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

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

• メールスレッドを検索して閲覧する
• 会話をきれいなテキスト形式で表示する
• マークダウンを使用して新しいメールを作成する
• 引用されたコンテンツの重複をスマートに排除してスレッドに返信する
• LaTeX風のスタイルで美しいメールを作成
• 設定されたスクリプトを実行してメールデータベースを同期します

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

インストール

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

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 デスクトップ アーティファクト内のローカル ファイルにアクセスします。