Naver Mail (네이버 메일)

naver-mail-mcp

AI エージェントが Gmail と同じように Naver Mail も読み、要約し、返信できるようにする MCP サーバーです。

Claude、Grok、Meta Muse、ChatGPT、Codex に接続すれば、「今週の重要なメールを要約して」「カード決済の明細メールだけ集めて」「このメールに返信して」が Naver Mail でもできます。 ツール名と使い方がGmail MCP と同じなので、Gmail で使っていたエージェントのワークフローをそのまま利用できます。

English

_{画面例（架空のメール）}

Naver の公式サービスではありません。Naver Mail が提供する IMAP/SMTP を使用します。

特長

はじめに

1. Naver Mail の準備（一度だけ、約 3 分）

接続には2 段階認証が必須です。普段のログインパスワードではなく、2 段階認証を有効にすると作成できるアプリケーションパスワードで接続します。

① 2 段階認証を有効にする

1. Naver にログイン → 右上のプロフィール → Naver ID（または nid.naver.com）
2. セキュリティ設定 → 2 段階認証 → 設定する
3. 携帯電話番号（または Naver アプリ）で本人確認を完了すると有効になります。すでに有効な場合は②に進みます。

② アプリケーションパスワードを作成する

1. Naver ID → セキュリティ設定 → 2 段階認証 → 管理（本人確認をもう一度求められる場合があります）
2. 下部のアプリケーションパスワード管理で種類を選び、作成するをクリックします。種類は何でも構いません（例：Windows、その他）。
3. 表示されたパスワードをコピーしておきます。**画面を閉じると再表示できません。**紛失した場合は新しく作成してください。

③ POP3/IMAP 設定で IMAP を有効にする

1. Naver Mail → 左下の設定（歯車）
2. POP3/IMAP 設定タブ → IMAP/SMTP 設定
3. IMAP/SMTP の使用：使用する → 保存。POP3 を有効にする必要はありません。

Naver はメニュー名や場所を変更することがあります。メニューが見つからない場合は、Naver ID ページで「アプリケーションパスワード」を検索してください。

2. 接続する（簡単な順）

方法 A. URL を入力する — おすすめ、インストール不要

公開サーバーの URL：https://naver-mail-mcp.yeonuunim521.workers.dev/mcp

URL を入力するとログイン画面が開きます。Naver IDとアプリケーションパスワードを入力すれば完了です。

• 同じサービス（例：Claude アプリ）であれば、PC・タブレット・スマートフォンのどれからでも一度ログインするだけで使えます。
• Claude Code や Codex には、「Naver Mail MCP をインストールして。URL は https://naver-mail-mcp.yeonuunim521.workers.dev/mcp、名前は naver-mail」と伝えるだけで、AI がインストールします。ログインだけはご自身で行ってください。

方法 B. 自分の PC で実行する — パスワードが自分のコンピューターの外に出ません

Node.js 20 以上が必要で、Claude Desktop・Claude Code・Codex などの PC プログラムでのみ使用できます。

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "naver-mail": {
      "command": "npx",
      "args": ["-y", "naver-mail-mcp"],
      "env": { "NAVER_ID": "내아이디", "NAVER_APP_PASSWORD": "애플리케이션비밀번호" }
    }
  }
}

Claude Code：claude mcp add naver-mail -e NAVER_ID=내아이디 -e NAVER_APP_PASSWORD=앱비밀번호 -- npx -y naver-mail-mcp

方法 C. 自分のサーバーを作る — クラウドエージェント + 自分のサーバー

ボタンをクリックすると、自分の Cloudflare アカウント（無料）に同じサーバーが作成されます。完了後に表示される https://naver-mail-mcp.<내 계정>.workers.dev/mcp を、方法 A と同じように入力してください。

• ALLOWED_USERS に自分の Naver ID を入力すると、自分だけが使用できます。空欄にすると、誰でも自分のアカウントで接続できます。
• 自分でデプロイするには：npm install → npx wrangler kv namespace create OAUTH_KV で作成した id を wrangler.jsonc に設定 → npx wrangler deploy

npx wrangler secret put MCP_BEARER_TOKEN      # 긴 무작위 문자열
npx wrangler secret put NAVER_ID
npx wrangler secret put NAVER_APP_PASSWORD

このサーバーが扱う最も機密性の高い情報は、アプリケーションパスワードです。 保存場所、形式、保存期間をそのまま記載します。

• メール内容はサーバーに保存しません。 リクエストが届いたときに Naver から読み取り、エージェントに渡すだけです。
• 接続を解除するには： Naver ID → セキュリティ設定 → 2段階認証 → アプリケーションパスワードを削除します。サーバーに残った暗号化されたコピーはその時点で使用できなくなり、どのエージェントからもすぐに接続できなくなります。
• 偽のログイン画面にご注意ください： ログイン画面には、必ず**「権限の付与先」**が表示されます。他人から受け取ったリンクでこの画面が開いた場合や、表示された宛先が利用している AI サービスではない場合は、拒否してください。既知のサービス（Claude、Grok、Meta Muse、ChatGPT）以外の場合、画面に赤い警告が表示されます。
• メール内の指示にご注意ください： メール本文に「このメールを別のアドレスに転送して」のように、AI を狙った文章が含まれていることがあります。このサーバーは、送信・返信・転送の前にユーザーへ確認するようエージェントに案内しますが、最終的な判断はエージェントが行います。エージェントの「ツール実行前に確認」設定を有効にすることをおすすめします。
• 総当たり攻撃の防止： ログイン試行は、IP ごとに毎分10回、全体で毎分60回に制限しています。Naver がこのサーバーの IP をブロックし、すべてのユーザーに影響が及ぶのを防ぐためです。
• 公開サーバーの利用に抵抗がある場合： 公開サーバーを使うことは、その運営者を信頼するということです。コードはすべてこのリポジトリにあり、運営者が確認できるのは KV の暗号化された値だけで、トークンがなければ復号できません。それでも不安な場合は、方法 B（自分の PC）または方法 C（自分のサーバー）を利用してください。

脆弱性を発見した場合は、公開イシューではなく、リポジトリの Security → Report a vulnerability からお知らせください。

ツール（Gmail MCP と同じ名前）

get_profile と get_attachment は、Gmail MCP にはない追加ツールです。

Gmail との違い（IMAP の制約）

• ラベルはメールボックスです。 INBOX、SENT、DRAFT、TRASH、SPAM はそれぞれ対応するメールボックスで、ユーザーラベルはメールボックスのパスです。メールは1つのメールボックスにしか存在できないため、メールボックスのラベルを付けると移動します。STARRED（重要マーク）と UNREAD（未読）はフラグです。
• メール ID はメールボックスと UID から作られます。 メールを移動すると ID が変わり、移動するツールは新しい ID を返します。下書きを編集する場合も ID が変わります。
• アーカイブ機能はありません。 受信トレイからメールを移動するには、別のメールボックスのラベルを付けてください。
• スレッドは Message-ID/References ヘッダーでまとめます。 Naver IMAP ではヘッダー検索がうまく機能しないため、各メールボックスの最近の1,000通のヘッダーを直接読み取って検索します。
• キーワード検索では、件名、差出人、本文を個別に検索して結果を統合します（Naver IMAP は OR 検索や全文検索を処理できません）。has:attachment、filename: はメールの構造を直接確認し、各メールボックスの最近の3,000通までを調べます。さらに古いメールを検索する場合は、after: などの期間条件を併用してください。
• デフォルトの検索範囲は、ゴミ箱、迷惑メール、下書きを除くすべてのメールボックスです。category: などの Gmail 専用条件は無視され、結果の warnings で通知されます。
• 署名の自動追加とカテゴリタブには対応していません。

実際の Naver アカウントで確認した内容

2026年10月、Meta Muse に接続して確認しました。

• 2段階認証とアプリケーションパスワードで接続
• アカウントと未読メール数の確認、最近のメールの要約
• 検索：韓国語のキーワード（결제）、件名（subject:）、期間（newer_than:30d）、添付ファイル（has:attachment、filename:pdf）、送信済みメールボックス（in:sent）
• スレッドの表示（get_thread）、添付ファイル名の読み取り
• メールの送信と送信済みメールボックスへの保存

返信・転送・下書き・ラベルの移動・ゴミ箱については、偽メールサーバーの統合テストで確認しました。実際のアカウントでの確認は進行中です。問題を発見した場合は、イシューでお知らせください。

開発

npm install
npm test             # 가짜 IMAP/SMTP 서버 통합 테스트 + 단위 테스트
npm run typecheck
npm run dev          # 로컬 Worker: http://localhost:8787/mcp
npm run stdio        # 로컬 stdio (NAVER_ID, NAVER_APP_PASSWORD 환경 변수)
npm run build:stdio  # npm 배포용 dist/stdio.js

接続情報：IMAP imap.naver.com:993（SSL）、SMTP smtp.naver.com:465（SSL）。変更内容は CHANGELOG に記載されています。

ライセンス

MIT