이번 주 영수증 메일을 '영수증' 폴더로 옮겨줘
영수증 메일 3통을 '영수증' 폴더로 옮겼습니다.
search_emails, create_folder, move_emails
Korean Mail MCP for Claude
네이버, 다음, 카카오 메일함을 Claude Code에 연결합니다. 이 플러그인이 띄우는 MCP 서버를 통해 Claude가 IMAP과 SMTP로 메일을 검색하고, 읽고, 초안을 쓰고, 보내고, 정리할 수 있습니다.
서버 하나가 계정 하나를 맡거나 여러 계정을 나열하면 그만큼 맡고, 접속할 메일 서비스는 각 주소의 도메인으로 정합니다.
설치
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를 켭니다. 네이버: 메일 → 환경설정 → POP3/IMAP 설정 → IMAP/SMTP 사용. 다음·카카오: 메일 → 설정 → IMAP/POP3 → IMAP 사용.
- IMAP용 비밀번호를 준비합니다. 로그인 비밀번호가 아닙니다. 네이버: 내 정보 → 보안설정 → 2단계 인증 → 애플리케이션 비밀번호 관리. 다음·카카오: IMAP 설정 화면에서 안내하는 전용 비밀번호.
- 플러그인을 켜면 Claude Code가 네이버, 다음, 카카오마다 메일 주소와 위의 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개입니다. 이 서비스들에는 라벨이 없고 메일 하나는 폴더 하나에만 들어가므로, 분류는 폴더를 만들고 그 안으로 옮기는 방식으로 합니다.
get_profile- 계정의 주소, 이름, 전체 메일 수, 안읽은 메일 수.
search_emails- 발신자, 수신자, 제목, 날짜, 읽음 여부로 폴더를 검색하고 페이지로 나눠 돌려줍니다.
read_email- UID로 메일 하나를 읽습니다. 헤더, 본문, 첨부파일 목록을 줍니다.
read_thread- Message-ID가 속한 대화 스레드를 읽습니다.
list_folders- 폴더 목록과 폴더별 메일 수, 안읽은 수.
create_draft- 새 메일을 임시보관함에 저장합니다.
list_drafts- 임시보관함의 초안 목록.
send_email- SMTP로 새 메일이나 답장을 보냅니다.
download_attachment- 첨부파일 하나를 base64로 내려받습니다. 최대 10MB.
create_folder- 폴더를 만듭니다. 이름은 한글도 됩니다.
move_emails- 메일을 다른 폴더로 옮깁니다. 한 번에 최대 500통.
mark_read- 읽음 또는 안읽음으로 표시합니다. 한 번에 최대 500통.
trash_emails- 휴지통으로 옮깁니다. 한 번에 최대 500통이고, 영구 삭제는 하지 않습니다.
동작
플러그인은 MCP 서버 하나를 등록합니다. Claude Code가 이 저장소의 서버를 uvx로 띄워 stdio로 대화하고, 입력한 값은 환경변수로 전달됩니다. 도구를 호출할 때마다 IMAP이나 SMTP 연결을 새로 열고 끝나면 닫습니다.
서버는 내 컴퓨터에서 돌고 메일 서비스에만 접속합니다. IMAP 인젝션과 헤더 인젝션을 막고, 첨부파일 크기를 10MB로 제한합니다.
서비스마다 다른 점
세 서비스는 IMAP에 답하는 방식이 달라서 서버가 그 차이를 메웁니다. 눈에 띄는 차이는 아래와 같고, 모두 2026-11-16에 실제 계정으로 쟀습니다.
- 다음, 카카오
- 한글 검색어는 서버에서 아무것도 찾지 못하고, 본문 검색도 마찬가지입니다. 그래서 서버가 헤더를 내려받아 직접 대조하며, 몇 초 걸립니다. 본문 검색은 할 수 없습니다.
- 네이버
- 헤더를 받아 오는 데 메일당 약 50ms가 들어서, 텍스트 검색은 기본으로 서버에 맡깁니다. 이 검색은 대소문자를 가리지 않고 최신 1,000건까지만 돌려줍니다. 느리지만 정확한 검색이 필요하면
text_search를local로 지정합니다. - 다음
- IMAP으로는 폴더마다 최근 400통만 닿습니다. 그보다 오래된 메일은 UID로도 열거나 옮길 수 없습니다.
- 네이버
- 폴더에는 웹 설정의 IMAP 동기화 메일 제한만큼만 보입니다. 최대 5,000통입니다.
- 확인하지 않은 것
- 여러 통을 한 번에 옮기는 경우와 없는 폴더로 옮기는 오류 경로입니다. 메일함을 바꾸는 도구는 서비스마다 시험 메일 한 통으로 확인했습니다.
자주 묻는 질문
Claude가 마음대로 메일을 보내거나 지우나요?
도구를 호출해야만 하고, 허용해 두지 않았다면 Claude Code가 실행 전에 묻습니다. trash_emails는 휴지통으로 옮길 뿐 영구 삭제하지 않습니다. send_email은 바로 보내므로, 먼저 읽어 보고 싶다면 create_draft를 쓰세요.
계정을 여러 개 쓸 수 있나요?
네. 플러그인은 서비스마다 계정 하나씩, 최대 세 계정을 맡습니다. Claude Code가 물을 때 쓰는 서비스만 채우고 나머지는 비워 둡니다. 계정이 여럿이면 모든 도구가 account 인자(naver, daum, kakao)를 받습니다. search_emails처럼 읽기만 하는 도구는 account를 생략하면 모든 계정에서 실행되고, 메일을 보내거나 바꾸는 도구는 반드시 지정해야 합니다. 같은 서비스의 계정이 둘이라면 서버를 직접 등록합니다. README처럼 MAIL_ACCOUNTS에 이름을 나열해 서버 하나로 묶거나, claude mcp add로 계정마다 서버를 따로 등록할 수 있고, 이때는 서버 이름이 서로 달라야 합니다(네이버 계정이 둘이면 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에 네이버, 다음, 카카오 실제 계정으로 돌렸습니다.
끄거나 제거하려면 어떻게 하나요?
끄려면 claude plugin disable korean-mail-mcp, 제거하려면 claude plugin uninstall korean-mail-mcp를 실행합니다.
어디서 온 프로젝트인가요?
chanmuzi/naver-mail-mcp를 fork해서 다음·카카오 지원과 메일함 정리 도구를 더했습니다.