claws-mail-mcp-plugin

claws-mail-mcp-plugin

実行中のメールクライアントを MCP サーバーとして公開する、Claws Mail 用のネイティブプラグインです。

Claws Mail 内で動作し、ローカルのループバック専用 HTTP エンドポイント（MCP over JSON-RPC、ベアラートークンで保護）を提供します。MCP 対応の AI ツールなら、設定済みのアカウントを使って、フォルダーやメッセージの読み取り、検索、作成、返信、転送、フォルダーやフラグの管理、メールの送受信ができます。エンドポイント、ポート、トークン、読み取り専用モードは Claws Mail の設定ディレクトリ内にある mcp_pluginrc で設定します。プラグインは起動のたびに、すぐに貼り付けて使えるクライアント設定を同じ場所の mcp_client.json に書き込みます。

---

プラグインのインストール

ビルド済みバイナリは各リリースに添付されており、OS と対応する Claws Mail のバージョンごとに用意されています（例：mcp-linux-claws4.3.1.so、mcp-windows-claws4.3.0.dll）。お使いの Claws Mail のバージョンと OS に合うファイルを選び、次の手順でインストールしてください。

1. ~/.claws-mail/plugins や、Windows の場合は %APPDATA%\Claws-mail\plugins など、任意のフォルダーに mcp.so または mcp.dll として保存します。ファイル名の末尾が _plugin.so または _plugin.dll の場合を除き、どのようなファイル名でも使用できます。Claws Mail はそのようなファイルを起動時に読み込まず、プラグイン一覧から削除します。
2. Claws Mail で「Configuration」>「Plugins」を開き、「Load...」をクリックしてファイルを選択します。

Claws Mail は起動のたびにプラグインを再度読み込みます。

ソースからビルドする場合は、ビルドを参照してください。

---

AI ツールへの接続

プラグインを読み込むと、Claws Mail の設定ディレクトリにある mcp_client.json に、実際のエンドポイント URL とベアラートークンが書き込まれます。お使いのツールに合った以下の方法で、この2つの値を使用してください。サーバーはループバック（127.0.0.1）専用なので、Claws Mail と同じマシンで実行されている AI ツールからのみ接続できます。

Claude Code

claude mcp add --transport http claws-mail http://127.0.0.1:8765/mcp \
  --header "Authorization: Bearer <TOKEN>"

Claude Desktop

「Settings」>「Developer」>「Edit Config」を開き、packaging/claude/mcp.json の内容をマージしてください（<TOKEN> を入力してください）。このサーバーへの接続に「Add custom connector」UIを使用しないでください。この方法ではお使いのマシンではなく Anthropic のサーバーから接続するため、ループバックアドレスには到達できません。

VS Code / GitHub Copilot Chat

code --add-mcp "{\"name\":\"claws-mail\",\"type\":\"http\",\"url\":\"http://127.0.0.1:8765/mcp\",\"headers\":{\"Authorization\":\"Bearer <TOKEN>\"}}"

または、packaging/vscode/mcp.json を .vscode/mcp.json にコピーしてください。トークンをファイルに保存する代わりに、入力を求められます。

Codex CLI

export CLAWS_MCP_TOKEN=<TOKEN>
codex mcp add claws-mail --url http://127.0.0.1:8765/mcp --bearer-token-env-var CLAWS_MCP_TOKEN

これは Codex が ~/.codex/config.toml から読み込む packaging/codex/config.toml の内容と一致します。

MCP registry

このプラグインは MCP registry に io.github.it-atelier-gn/claws-mail-mcp-plugin として掲載されています。掲載情報には接続の詳細は含まれていません。上記の手順に従ってプラグインをインストールし、お使いのツールを接続してください。

---

ビルド

Meson、Ninja、C コンパイラー、および Claws Mail の開発ファイルが必要です （GTK3、GLib、GnuTLS、libgcrypt。Linux では enchant も必要です）。

Linux

依存関係をインストールします（Debian/Ubuntu の例）。

sudo apt-get install build-essential meson ninja-build pkg-config \
  libgtk-3-dev libglib2.0-dev libgnutls28-dev libgcrypt20-dev libenchant-2-dev

claws-mail の pkg-config ファイルがシステムにない場合は、次のように作成してください。

PREFIX="$PWD/.claws-sdk" ci/build-claws-sdk.sh
export PKG_CONFIG_PATH="$PWD/.claws-sdk/lib/pkgconfig"

その後、設定してビルドします。

meson setup build
meson compile -C build
meson test -C build

プラグインは build/mcp.so にビルドされます。

Windows（MSYS2）

MINGW64 ツールチェーンと依存関係をインストールします。

pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-meson mingw-w64-x86_64-ninja \
  mingw-w64-x86_64-pkgconf mingw-w64-x86_64-gtk3 mingw-w64-x86_64-glib2 \
  mingw-w64-x86_64-gnutls mingw-w64-x86_64-libgcrypt

上記の手順で Claws Mail SDK をビルドし、PKG_CONFIG_PATH を設定してから、同じ meson setup／meson compile／meson test コマンドを実行してください。プラグインは build/mcp.dll にビルドされます。

プラグインのバージョン

バイナリにコンパイルされるバージョン（plugin_version と status ツールが返す値）は -Dplugin_version から取得します。例：

meson setup build -Dplugin_version=1.2.3

CI はリリースビルド時に、プッシュされた git タグからこの値を設定します。指定されていない場合、ビルドでは git describe、それも使えない場合は 0.0.0-dev にフォールバックします。

インストール

meson install -C build

Claws Mail のプラグインディレクトリにプラグインをインストールします。ディレクトリは pkg-config --variable=plugindir claws-mail で確認できます。インストール後、Configuration > Plugins > Load... から一度読み込んでください。

---

対応する Claws Mail のバージョン

各リリースには、ci/claws-versions.json に記載されているすべての Claws Mail バージョン向けに、Linux 版と Windows 版のビルドが含まれています。

---

ライセンス

GPL-3.0-or-later。詳しくは LICENSE をご覧ください。