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-mcpAnswer 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-mcpIn 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
- 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.
- 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.
- 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.comimap.naver.comandsmtp.naver.comdaum.net,hanmail.netimap.daum.netandsmtp.daum.netkakao.comimap.kakao.comandsmtp.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_searchtolocalfor 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.