네이버메일 MCP — Claude에서 네이버 메일 읽고 보내는 오픈소스
안녕하세요. 야금야금입니다.
"Claude에서는 Gmail MCP처럼 메일을 읽는데, 네이버 메일은 안 되나" — 스레드에서 네이버메일 MCP를 찾았다는 글을 보고 공식 저장소 기준으로 정리했습니다. Claude·ChatGPT 같은 AI에서 네이버 메일을 읽고 쓸 수 있게 해주는 MCP 서버입니다.
✔️ 네이버메일 MCP — Claude Desktop에서 네이버 메일을 쓰는 MCP 서버
✔️ 실행은
uvx naver-mail-mcp 한 줄, 설정은 IMAP·SMTP 허용 + 앱 비밀번호✔️ 검색·읽기·스레드·초안·발송·첨부까지 9종 도구, MIT 라이선스

이게 뭔데 — Gmail MCP의 네이버 버전
메일함 자체가 아니라 AI와 메일함을 잇는 다리입니다
1무엇이 다른가
네이버 IMAP·SMTP를 AI가 부를 수 있는 9개 도구로 감쌉니다
이 프로젝트는 네이버 메일을 Claude Desktop에서 Gmail MCP처럼 쓰게 해주는 MCP 서버입니다. AI가 직접 메일 비밀번호를 들고 다니는 게 아니라, 표준 프로토콜(IMAP 읽기·SMTP 발송) 위에 검색·읽기·스레드·초안·발송 같은 작업 9종을 도구로 올려둔 구조입니다.
연결 방식은 무상태(stateless)입니다. 각 도구 호출 때마다 새로 연결하고 끝내며, 전송 방식은 stdio라 Claude Desktop 연동이 전제입니다. 인코딩은 UTF-8·EUC-KR·Modified UTF-7(폴더명)까지 자동 처리한다고 밝히고 있습니다.
주요 기능 — 9종 도구
읽기부터 초안·발송·첨부까지 한 세트입니다
2기능 목록
무엇을 하는지 + 어디에 쓰는지 함께 봅니다
| 도구 | 하는 일 | 쓰임 |
|---|---|---|
| get_profile | 이메일·이름·전체/안읽음 수 조회 | 연결 확인용 첫 호출 |
| search_emails | 발신자·수신자·제목·날짜·읽음 여부 검색 + 페이지네이션 | 문의 분류·검수 대상 찾기 |
| read_email | UID로 헤더·본문·첨부 메타 읽기 | 본문 정독 |
| read_thread | Message-ID 기준 대화 스레드 조회 | 오간 맥락 복원 |
| list_folders | 폴더별 메시지·안읽음 수 조회 | 폴더명 확인할 때 먼저 |
| create_draft · list_drafts | Drafts에 초안 저장·조회 | 바로 보내기 전 검토 |
| send_email | SMTP 발송, 새 메일·답장 지원 | 회신·발송 자동화 |
| download_attachment | 첨부 다운로드(base64, 10MB 제한) | 파일 꺼내기 |
설치·실행 — 공식 절차 그대로
검증된 명령과 설정만 적습니다
3전제 조건 3가지
순서대로 켜야 인증 실패가 안 납니다
여기에 Python 3.10 이상이 필요합니다. 저장소의 문제 해결 표도 "IMAP 인증 실패 = 앱 비밀번호 확인"이라고 못 박고 있습니다.
4실행과 등록
실행 한 줄 + 설정 파일 한 블록입니다
실행: uvx naver-mail-mcp
등록(claude_desktop_config.json의 mcpServers에 추가):
naver-email → command uvx, args ["naver-mail-mcp"], env에 NAVER_EMAIL_ADDRESS·NAVER_EMAIL_PASSWORD·NAVER_FULL_NAME
command에 which uv로 확인한 uv 절대 경로를 넣어야 "프로세스를 띄울 수 없다"는 오류가 안 납니다.어울리는 사람
이런 분에게 맞습니다
- ✔️ 네이버 메일을 주로 쓰면서 Claude로 메일 정리·회신을 붙이고 싶은 분
- ✔️ 문의 분류·라우팅·검수 같은 "고르기 작업"을 로컬 AI에 맡기고 싶은 분
- ✔️ 바로 발송보다 초안 저장 → 검토 → 발송 흐름을 원하는 분
- ✔️ 서버 없이 stdio 한 줄로 끝나는 가벼운 연동을 찾는 분
자주 묻는 질문
Q. 네이버 메일을 Claude에서 쓰려면 뭘 켜야 하나요?
A. 네이버 메일 설정에서 POP3/IMAP 설정의 IMAP/SMTP 사용을 켜고, 네이버 계정에 2단계 인증을 건 뒤 애플리케이션 비밀번호를 발급합니다. 계정 비밀번호가 아니라 이 앱 비밀번호를 MCP 설정에 넣어야 합니다.
Q. 네이버메일 MCP 설치는 어떻게 하나요?
A. 실행은 uvx naver-mail-mcp 한 줄이며, claude_desktop_config.json의 mcpServers에 naver-email 항목으로 command uvx, args naver-mail-mcp, 환경변수 NAVER_EMAIL_ADDRESS·NAVER_EMAIL_PASSWORD·NAVER_FULL_NAME을 등록합니다. Claude Desktop은 시스템 PATH를 상속하지 않으니 로컬 실행 시 uv는 절대 경로로 적습니다.
Q. 네이버메일 MCP로 뭘 할 수 있나요?
A. 9종 도구로 프로필 조회, 조건 검색(발신자·수신자·제목·날짜·읽음 여부·페이지네이션), UID로 전체 읽기, Message-ID 기준 스레드 조회, 폴더 목록, 초안 저장·조회, SMTP 발송(새 메일·답장), 첨부파일 다운로드(base64, 10MB 제한)를 할 수 있습니다.
Q. 쓸 때 주의할 점은요?
A. 세 가지입니다. 첫째 IMAP 인증 실패는 대개 계정 비밀번호를 넣어서 생기니 앱 비밀번호인지 확인합니다. 둘째 Claude Desktop 설정의 uv 경로는 which uv로 확인한 절대 경로를 씁니다. 셋째 폴더가 안 맞으면 list_folders로 실제 폴더명을 먼저 확인하고, 첨부는 10MB까지만 됩니다.



댓글 0개