Naver Mail (네이버 메일)

naver-mail-mcp

这是一个 MCP 服务，让 AI Agent 像读取 Gmail 一样读取、总结和回复 Naver Mail。

连接 Claude、Grok、Meta Muse、ChatGPT、Codex 后，也可以在 Naver Mail 中使用“总结本周的重要邮件”“只汇总银行卡消费记录邮件”“回复这封邮件”等功能。 由于工具名称和用法与 Gmail MCP 相同，可以直接沿用之前通过 Gmail 使用的 Agent 工作流。

English

_{示例画面（虚构邮件）}

这不是 Naver 的官方服务。它通过 Naver Mail 提供的 IMAP/SMTP 运行。

有何不同

开始使用

1. 准备 Naver Mail（仅需一次，约 3 分钟）

连接时必须启用两步验证。连接时使用的不是日常登录密码，而是启用两步验证后才能创建的应用专用密码。

① 启用两步验证

1. 登录 Naver → 右上角个人资料 → Naver ID（或访问 nid.naver.com）
2. 安全设置 → 两步验证 → 设置
3. 通过手机号码（或 Naver 应用）完成身份验证后即可启用。如果已经启用，请继续第②步。

② 创建应用专用密码

1. Naver ID → 安全设置 → 两步验证 → 管理（可能需要再次验证身份）
2. 在下方的应用专用密码管理中选择类型，然后点击生成。类型任选（例如 Windows、其他）即可。
3. 复制生成的密码。**关闭窗口后将无法再次查看。**如果丢失，重新创建即可。

③ 在 POP3/IMAP 设置中启用 IMAP

1. 进入 Naver Mail → 左下角的设置（齿轮图标）
2. POP3/IMAP 设置标签页 → IMAP/SMTP 设置
3. 选择启用 IMAP/SMTP → 保存。无需启用 POP3。

Naver 偶尔会更改菜单名称和位置。如果找不到菜单，请在 Naver ID 页面搜索“应用专用密码”。

2. 连接（从简单的方法开始）

方法 A：只需填写地址——推荐，无需安装

公开服务地址：https://naver-mail-mcp.yeonuunim521.workers.dev/mcp

填写地址后会打开登录页面。输入Naver ID和应用专用密码即可完成。

• 对于同一项服务（例如 Claude 应用），只需登录一次，即可在 PC、平板电脑和手机上使用。
• 只需对 Claude Code 或 Codex 说“帮我安装 Naver Mail MCP。地址是 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：创建自己的服务——云端 Agent + 自己的服务

点击按钮后，会在自己的 Cloudflare 账户中创建相同的服务（免费）。完成后，将显示的 https://naver-mail-mcp.<내 계정>.workers.dev/mcp 像方法 A 一样添加即可。

• 将自己的 Naver ID 添加到 ALLOWED_USERS 后，只有自己可以使用。留空则任何人都可以使用自己的账户连接。
• 手动部署方法：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 读取邮件并传递给 Agent。
• 断开连接： 前往 Naver ID → 安全设置 → 两步验证 → 删除应用专用密码。服务器上留存的加密副本会立即失效，并会立刻断开任何 Agent 的连接。
• 谨防虚假登录页面： 登录页面始终会显示**“权限将授予的对象”。如果是通过别人发来的链接打开此页面，或者显示的地址不是你使用的 AI 服务，请拒绝**。如果服务不在已知服务（Claude、Grok、Meta Muse、ChatGPT）之列，页面会显示红色警告。
• 谨防邮件中的指令： 邮件正文中可能包含“将这封邮件转发到其他地址”等针对 AI 的语句。此服务器会提示 Agent 在发送、回复或转发前向用户确认，但最终判断由 Agent 作出。建议开启 Agent 的“执行工具前确认”设置。
• 防止暴力破解： 每个 IP 的登录尝试限制为每分钟 10 次，全局限制为每分钟 60 次。此举旨在防止 Naver 屏蔽此服务器的 IP，导致所有用户受到影响。
• 如果不放心使用公共服务器： 使用公共服务器意味着信任其运营者。代码全部公开在此仓库中，运营者也只能看到 KV 中的加密值，没有令牌就无法解密。如果仍然不放心，请使用方法 B（自己的电脑）或方法 C（自己的服务器）。

如果发现漏洞，请通过仓库中的 Security → Report a vulnerability 报告，而不要公开提交 Issue。

工具（名称与 Gmail MCP 相同）

get_profile 和 get_attachment 是 Gmail MCP 中没有的额外工具。

与 Gmail 的不同之处（IMAP 的局限）

• 标签就是邮箱。 INBOX、SENT、DRAFT、TRASH、SPAM 分别对应相应的邮箱，用户标签则是邮箱路径。一封邮件只能存在于一个邮箱中，因此添加邮箱标签会将邮件移动到该邮箱。STARRED（已加星标）和 UNREAD（未读）是标记。
• 邮件 ID 由邮箱和 UID 组成。 移动邮件后，ID 会改变，移动工具会返回新的 ID。修改草稿邮件时，ID 也会改变。
• 不支持归档。 若要将邮件移出收件箱，请添加其他邮箱标签。
• 对话（thread）通过 Message-ID/References 标头归组。 Naver IMAP 不擅长搜索标头，因此会直接读取每个邮箱最近 1,000 封邮件的标头进行查找。
• 关键词搜索会分别搜索主题、发件人和正文，再合并结果（Naver IMAP 无法处理 OR 和全文搜索）。has:attachment、filename: 会直接检查邮件结构，并查看每个邮箱最近 3,000 封邮件。搜索更早的邮件时，请同时使用 after: 等时间范围条件。
• 默认搜索范围为除垃圾箱、垃圾邮件和草稿以外的所有邮箱。category: 等 Gmail 专用条件会被忽略，并在结果的 warnings 中提示。
• 不支持自动添加签名和分类标签页。

在真实 Naver 账户中验证的内容

2026 年 10 月，通过 Meta Muse 连接并进行了验证。

• 使用两步验证和应用专用密码连接
• 查看账户信息和未读邮件数量，获取近期邮件摘要
• 搜索：韩文关键词（결제）、主题（subject:）、时间范围（newer_than:30d）、附件（has:attachment、filename:pdf）、已发送邮件箱（in:sent）
• 查看归组后的对话（get_thread），读取附件名称
• 发送邮件并保存到已发送邮件箱

回复、转发、草稿、标签移动和垃圾箱功能已通过虚假邮件服务器集成测试验证，真实账户验证仍在进行中。如发现问题，请通过Issue告知我们。

开发

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