korean-mail-mcp

Move this week's receipt emails into a Receipts folder

Moved 3 receipt emails into the Receipts folder.

search_emails, create_folder, move_emails

Korean Mail MCP for Claude

Connects a Naver, Daum or Kakao mailbox to Claude Code. Through an MCP server that this plugin starts, Claude can search, read, draft, send and sort your mail over IMAP and SMTP.

One server serves one account, or several when you list them, and the mail service is chosen by the domain of each address.

Install

At the Claude Code terminal prompt:

/plugin install korean-mail-mcp --marketplace M1nu0x0/korean-mail-mcp

Answer y to Add marketplace? and choose the user scope. Claude Code then asks for the address and IMAP password of each service you use. uv must be installed so that uvx is on your PATH.

From a shell:

claude plugin install korean-mail-mcp --marketplace M1nu0x0/korean-mail-mcp

In Claude Desktop, click + next to the prompt box → Plugins → Add marketplace, enter M1nu0x0/korean-mail-mcp, then add korean-mail-mcp. It applies from the next session.

Before you install

  1. Turn on IMAP and SMTP in the mail service. Naver: Mail → Settings → POP3/IMAP → use IMAP/SMTP. Daum and Kakao: Mail → Settings → IMAP/POP3 → use IMAP.
  2. Get the password for IMAP, which is not your login password. Naver: My info → Security → 2-step verification → manage application passwords. Daum and Kakao: the dedicated password that their IMAP settings page shows.
  3. When you enable the plugin, Claude Code asks for an address and an IMAP password for each of Naver, Daum and Kakao, and an optional display name for the mail you send. Fill in only the services you use. The passwords are kept as sensitive values, not in settings.json.

Supported services

The domain of the address picks the servers. Both connections use SSL: IMAP on port 993 and SMTP on port 465.

naver.com
imap.naver.com and smtp.naver.com
daum.net, hanmail.net
imap.daum.net and smtp.daum.net
kakao.com
imap.kakao.com and smtp.kakao.com

Tools

Thirteen tools. These services have no labels and a message lives in one folder only, so sorting means creating folders and moving mail into them.

get_profile
The account's address, name, total messages and unread count.
search_emails
Search a folder by sender, recipient, subject, date or read state, in pages.
read_email
Read one message by UID: headers, body and the list of attachments.
read_thread
Read the conversation that a Message-ID belongs to.
list_folders
List the folders with their message and unread counts.
create_draft
Save a new message in the Drafts folder.
list_drafts
List what is in the Drafts folder.
send_email
Send a new message or a reply over SMTP.
download_attachment
Download one attachment, base64 encoded, up to 10 MB.
create_folder
Create a folder, with a Korean name if you like.
move_emails
Move messages to another folder, up to 500 at a time.
mark_read
Mark messages read or unread, up to 500 at a time.
trash_emails
Move messages to the trash, up to 500 at a time. Nothing is deleted for good.

How it works

The plugin registers one MCP server. Claude Code starts it with uvx from this repository and talks to it over stdio, and the values you entered reach it as environment variables. Each tool call opens a fresh IMAP or SMTP connection and closes it afterwards.

The server runs on your computer and connects only to your mail service. It guards against IMAP and header injection, and limits attachment size to 10 MB.

Differences between the services

The three services answer IMAP differently, and the server works around it. These are the differences you may notice, all measured on real accounts on 2026-11-16.

Daum, Kakao
A search with Korean text finds nothing on their servers, and neither does a search of message bodies. So the server downloads the headers and compares them itself, which takes a few seconds. Searching the body is not possible.
Naver
Fetching headers costs about 50 ms per message, so a text search is handed to the server by default. That match ignores case and returns only the newest 1,000 hits. Set text_search to local for the slower, exact search.
Daum
Only the newest 400 messages of each folder can be reached over IMAP. Older mail cannot be opened or moved, even by UID.
Naver
A folder shows only as many messages as the mail limit for IMAP sync in the web settings, at most 5,000.
Not tried
Moving many messages at once, and moving to a folder that does not exist. The tools that change a mailbox were tried on each service with one test message.

Questions

Will Claude send or delete mail on its own?

Only by calling a tool, and Claude Code asks before it runs a tool unless you have allowed it. trash_emails moves mail to the trash and never deletes it for good. send_email sends at once, so use create_draft when you want to read a message first.

Can I use more than one account?

Yes. The plugin holds one account per service, so up to three: fill in each service you use when Claude Code asks, and leave the others empty. With several accounts every tool takes an account argument (naver, daum or kakao). Tools that only read, such as search_emails, run on every account when you leave it out, while tools that send or change mail require it. For two accounts at the same service, register a server by hand: one server can hold several if you list their names in MAIL_ACCOUNTS, as the README shows, or you can register one server per account with claude mcp add, each under its own name, such as naver-mail-a and naver-mail-b for two Naver accounts.

Is the password my login password?

No. It must be the password made for IMAP, as described under "Before you install".

The server does not start. What now?

Check that uvx is on the PATH of the program that runs Claude. Claude Desktop does not inherit your shell's PATH. If it still fails, register the server by hand with the absolute path of uvx, as the README shows.

Which systems has it been tested on?

CI runs the unit tests on Ubuntu, Windows and macOS with Python 3.10 to 3.15, and checks the plugin files every day against the latest Claude Code. The integration tests ran on real Naver, Daum and Kakao accounts on 2026-11-16.

How do I remove it?

Run claude plugin disable korean-mail-mcp to turn it off, or claude plugin uninstall korean-mail-mcp to remove it.

Where does it come from?

It is a fork of chanmuzi/naver-mail-mcp that adds Daum and Kakao and the tools for sorting a mailbox.