스프쌤
스레드

네이버메일 MCP — Claude에서 네이버 메일 읽고 보내는 오픈소스

✍ 야금야금⏱ 5분 소요2026-10-15👁
← 목록으로 돌아가기

안녕하세요. 야금야금입니다.

"Claude에서는 Gmail MCP처럼 메일을 읽는데, 네이버 메일은 안 되나" — 스레드에서 네이버메일 MCP를 찾았다는 글을 보고 공식 저장소 기준으로 정리했습니다. Claude·ChatGPT 같은 AI에서 네이버 메일을 읽고 쓸 수 있게 해주는 MCP 서버입니다.

📌 한눈에 보는 요약
✔️ 네이버메일 MCP — Claude Desktop에서 네이버 메일을 쓰는 MCP 서버
✔️ 실행은 uvx naver-mail-mcp 한 줄, 설정은 IMAP·SMTP 허용 + 앱 비밀번호
✔️ 검색·읽기·스레드·초안·발송·첨부까지 9종 도구, MIT 라이선스
Claude와 네이버 메일 사이에서 MCP 서버가 요청을 주고받는 개념도
Claude ↔ 네이버메일 MCP ↔ 네이버 메일(IMAP·SMTP) — 주고받는 흐름 개념도
STEP 0

이게 뭔데 — 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(폴더명)까지 자동 처리한다고 밝히고 있습니다.

STEP 1

주요 기능 — 9종 도구

읽기부터 초안·발송·첨부까지 한 세트입니다

2기능 목록

무엇을 하는지 + 어디에 쓰는지 함께 봅니다


도구하는 일쓰임
get_profile이메일·이름·전체/안읽음 수 조회연결 확인용 첫 호출
search_emails발신자·수신자·제목·날짜·읽음 여부 검색 + 페이지네이션문의 분류·검수 대상 찾기
read_emailUID로 헤더·본문·첨부 메타 읽기본문 정독
read_threadMessage-ID 기준 대화 스레드 조회오간 맥락 복원
list_folders폴더별 메시지·안읽음 수 조회폴더명 확인할 때 먼저
create_draft · list_draftsDrafts에 초안 저장·조회바로 보내기 전 검토
send_emailSMTP 발송, 새 메일·답장 지원회신·발송 자동화
download_attachment첨부 다운로드(base64, 10MB 제한)파일 꺼내기
STEP 2

설치·실행 — 공식 절차 그대로

검증된 명령과 설정만 적습니다

3전제 조건 3가지

순서대로 켜야 인증 실패가 안 납니다


① 네이버 메일 → 설정 → POP3/IMAP 설정 → IMAP/SMTP 사용메일함 쪽 허용
→
② 네이버 내 정보 → 보안설정 → 2단계 인증필수 단계
→
③ 애플리케이션 비밀번호 발급계정 비번 아님

여기에 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

주의: Claude Desktop은 시스템 PATH를 상속하지 않습니다. 로컬 소스 실행이면 command에 which uv로 확인한 uv 절대 경로를 넣어야 "프로세스를 띄울 수 없다"는 오류가 안 납니다.
STEP 3

어울리는 사람

이런 분에게 맞습니다

  • ✔️ 네이버 메일을 주로 쓰면서 Claude로 메일 정리·회신을 붙이고 싶은 분
  • ✔️ 문의 분류·라우팅·검수 같은 "고르기 작업"을 로컬 AI에 맡기고 싶은 분
  • ✔️ 바로 발송보다 초안 저장 → 검토 → 발송 흐름을 원하는 분
  • ✔️ 서버 없이 stdio 한 줄로 끝나는 가벼운 연동을 찾는 분
💡 개인에게 주는 시사점 메일 자동화의 실패는 십중팔구 인증 설정에서 납니다. 앱 비밀번호와 폴더명 확인 두 가지만 먼저 하면 나머지 9종 도구는 그대로 돌아갑니다.

자주 묻는 질문

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까지만 됩니다.

원본

https://github.com/chanmuzi/naver-mail-mcp

https://www.threads.com/@tawoe/post/Dd8hkWSiUz8

함께 보면 좋은 글

댓글 0개