今週の領収書メールを「領収書」フォルダに移して
領収書メール3通を「領収書」フォルダに移しました。
search_emails, create_folder, move_emails
Korean Mail MCP for Claude
Naver、Daum、Kakao のメールボックスを Claude Code につなぎます。このプラグインが起動する MCP サーバー経由で、Claude が IMAP と SMTP でメールを検索し、読み、下書きし、送り、整理できます。
サーバー 1 つが 1 アカウントを担当するか、並べれば複数のアカウントを担当し、接続先のメールサービスは各アドレスのドメインで決まります。
インストール
Claude Code のターミナルのプロンプトで:
/plugin install korean-mail-mcp --marketplace M1nu0x0/korean-mail-mcpAdd marketplace? に y と答え、scope は user を選びます。続いて Claude Code が、使うサービスのメールアドレスと IMAP パスワードを尋ねます。uvx が PATH にあるよう、uv をインストールしておいてください。
シェルからは:
claude plugin install korean-mail-mcp --marketplace M1nu0x0/korean-mail-mcpClaude Desktop では、プロンプト横の + → Plugins → Add marketplace に M1nu0x0/korean-mail-mcp を入力し、korean-mail-mcp を追加します。次のセッションから適用されます。
インストールの前に
- メールサービスで IMAP と SMTP を有効にします。Naver: メール → 設定 → POP3/IMAP 設定 → IMAP/SMTP を使用。Daum と Kakao: メール → 設定 → IMAP/POP3 → IMAP を使用。
- IMAP 用のパスワードを用意します。ログインパスワードではありません。Naver: マイ情報 → セキュリティ設定 → 2 段階認証 → アプリケーションパスワードの管理。Daum と Kakao: IMAP 設定画面に表示される専用パスワード。
- プラグインを有効にすると、Claude Code が Naver、Daum、Kakao ごとにメールアドレスと上の IMAP パスワードを尋ね、送信メールに表示する名前(任意)も尋ねます。使うサービスだけ入力すれば構いません。パスワードは
settings.jsonではなく、機密値として別に保管されます。
対応サービス
アドレスのドメインで接続先のサーバーが決まります。どちらの接続も SSL で、IMAP はポート 993、SMTP はポート 465 です。
naver.comimap.naver.com、smtp.naver.comdaum.net、hanmail.netimap.daum.net、smtp.daum.netkakao.comimap.kakao.com、smtp.kakao.com
ツール
ツールは 13 個です。これらのサービスにラベルはなく、メール 1 通は 1 つのフォルダにだけ入るので、整理はフォルダを作ってそこへ移す形で行います。
get_profile- アカウントのアドレス、名前、メールの総数、未読数。
search_emails- 差出人、宛先、件名、日付、既読状態でフォルダを検索し、ページに分けて返します。
read_email- UID でメール 1 通を読みます。ヘッダー、本文、添付ファイルの一覧を返します。
read_thread- Message-ID が属するスレッドを読みます。
list_folders- フォルダの一覧と、フォルダごとのメール数、未読数。
create_draft- 新しいメールを下書きフォルダに保存します。
list_drafts- 下書きフォルダの一覧。
send_email- SMTP で新しいメールや返信を送ります。
download_attachment- 添付ファイル 1 つを base64 でダウンロードします。最大 10MB。
create_folder- フォルダを作ります。名前は韓国語でも構いません。
move_emails- メールを別のフォルダへ移します。一度に最大 500 通。
mark_read- 既読または未読にします。一度に最大 500 通。
trash_emails- ごみ箱へ移します。一度に最大 500 通で、完全な削除はしません。
動作
プラグインは MCP サーバーを 1 つ登録します。Claude Code がこのリポジトリのサーバーを uvx で起動して stdio でやり取りし、入力した値は環境変数として渡されます。ツールを呼ぶたびに IMAP や SMTP の接続を新しく開き、終われば閉じます。
サーバーは手元のコンピューターで動き、メールサービスにだけ接続します。IMAP インジェクションとヘッダーインジェクションを防ぎ、添付ファイルのサイズを 10MB に制限します。
サービスごとの違い
3 つのサービスは IMAP への答え方が違うので、サーバーがその差を埋めています。気づきやすい違いは次のとおりで、すべて 2026-11-16 に実際のアカウントで測りました。
- Daum、Kakao
- 韓国語の検索語はサーバーで何も見つからず、本文の検索も同じです。そのためサーバーがヘッダーをダウンロードして自分で照合し、数秒かかります。本文の検索はできません。
- Naver
- ヘッダーの取得に 1 通あたり約 50ms かかるため、テキスト検索は既定でサーバーに任せます。この検索は大文字小文字を区別せず、新しい 1,000 件までしか返しません。遅くても正確な検索が必要なら
text_searchをlocalにします。 - Daum
- IMAP で届くのは各フォルダの新しい 400 通だけです。それより古いメールは UID でも開けず、移せません。
- Naver
- フォルダに見えるのは、ウェブ設定の IMAP 同期メール制限の件数までです。最大 5,000 通です。
- 確かめていないこと
- 多数のメールを一度に移す場合と、存在しないフォルダへ移すエラーの経路です。メールボックスを変えるツールは、サービスごとにテストメール 1 通で確かめました。
よくある質問
Claude が勝手にメールを送ったり消したりしますか?
ツールを呼んだときだけで、許可していなければ Claude Code が実行前に確認します。trash_emails はごみ箱へ移すだけで、完全には削除しません。send_email はすぐ送るので、先に読みたいときは create_draft を使ってください。
アカウントを複数使えますか?
はい。プラグインは、サービスごとに 1 アカウントずつ、最大 3 つのアカウントを担当します。Claude Code に尋ねられたら、使うサービスだけ入力し、残りは空のままにします。アカウントが複数のとき、すべてのツールが account 引数(naver、daum、kakao)を受け取ります。search_emails のように読むだけのツールは、account を省略するとすべてのアカウントで実行され、メールを送る、変更するツールは必ず指定する必要があります。同じサービスのアカウントが 2 つある場合は、サーバーを手動で登録します。README のように MAIL_ACCOUNTS に名前を並べて 1 つのサーバーにまとめることも、claude mcp add でアカウントごとにサーバーを別に登録することもでき、後者ではサーバー名を変えます(Naver のアカウントが 2 つなら naver-mail-a、naver-mail-b)。
パスワードはログインパスワードですか?
いいえ。「インストールの前に」で説明した IMAP 用のパスワードが必要です。
サーバーが起動しません。
Claude を実行するプログラムの PATH に uvx があるか確認してください。Claude Desktop はシェルの PATH を引き継ぎません。それでも動かなければ、README のように uvx の絶対パスでサーバーを手動登録します。
どの環境で確認していますか?
CI が Ubuntu、Windows、macOS で Python 3.10 から 3.15 までの単体テストを実行し、毎日最新の Claude Code でプラグインのファイルを検査します。統合テストは 2026-11-16 に Naver、Daum、Kakao の実アカウントで実行しました。
無効化や削除はどうしますか?
無効にするには claude plugin disable korean-mail-mcp、削除するには claude plugin uninstall korean-mail-mcp を実行します。
どこから来たプロジェクトですか?
chanmuzi/naver-mail-mcp を fork し、Daum と Kakao への対応とメールボックスを整理するツールを加えたものです。