Naver Mail (네이버 메일)

Name: Naver Mail (네이버 메일)
Author: CapyKkuing

제작자: CapyKkuing버전 0.1.4i★ –i컴퓨터 또는 클라우드

레지스트리 이름io.github.CapyKkuing/naver-mail-mcp

설치

개요

제작자가 쓴 설명(영어 원문)

Read, search, reply to and organize Naver Mail with the same tools as the Gmail MCP (IMAP/SMTP).

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

사용자 의견i아직 리뷰가 없어요리뷰는 다음 단계에서 계정 기능과 함께 열려요
우리의 기본 점검i3개 중 3개 통과공개된 정보로 점검했으며, 코드는 아직 스캔하지 않았어요
사용 정도i아직 측정 안 함★ –

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

연결 방식: 컴퓨터 또는 클라우드
전송 방식: stdio, Streamable HTTP
카테고리: 채팅 및 이메일
입력해야 할 값: NAVER_ID, NAVER_APP_PASSWORD

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

기본 점검: 3개 중 3개 통과
제작자의 서버에서 실행돼요. 내가 요청한 내용은 제작자의 서버를 거쳐요.
직접 입력할 값: NAVER_ID, NAVER_APP_PASSWORD

비밀로 표시된 값은 내 계정의 열쇠예요. 절대 다른 사람과 공유하거나 채팅에 붙여 넣지 마세요.

필요한 것

클라우드에서 실행설치할 것 없음. 인터넷으로 연결돼요
npmNode.js 설치(npx 명령어용)

어떤 앱을 쓰세요?

ClaudeClaude CodeCursorVS CodeChatGPT

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

웹, 데스크톱, 모바일의 Claude에서 쓸 수 있어요:

Settings → Connectors 열기
Add custom connector 누르기
아래 주소를 붙여 넣고 Add 누르기
로그인하라고 하면 제작자의 서비스에 로그인하기

https://naver-mail-mcp.capykkuing.workers.dev/mcp

또는 내 컴퓨터에서 실행하기

Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요

{
  "mcpServers": {
    "naver-mail": {
      "command": "npx",
      "args": [
        "-y",
        "naver-mail-mcp"
      ],
      "env": {
        "NAVER_ID": "your-value",
        "NAVER_APP_PASSWORD": "your-value"
      }
    }
  }
}

터미널에서 이 명령어를 실행하세요

claude mcp add --transport http naver-mail https://naver-mail-mcp.capykkuing.workers.dev/mcp

또는 내 컴퓨터에서 실행하기

claude mcp add naver-mail --env NAVER_ID=your-value --env NAVER_APP_PASSWORD=your-value -- npx -y naver-mail-mcp

실행하기 전에 빈 값을 채워 주세요.

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요

{
  "mcpServers": {
    "naver-mail": {
      "url": "https://naver-mail-mcp.capykkuing.workers.dev/mcp"
    }
  }
}

또는 내 컴퓨터에서 실행하기

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요

{
  "mcpServers": {
    "naver-mail": {
      "command": "npx",
      "args": [
        "-y",
        "naver-mail-mcp"
      ],
      "env": {
        "NAVER_ID": "your-value",
        "NAVER_APP_PASSWORD": "your-value"
      }
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

{
  "servers": {
    "naver-mail": {
      "type": "http",
      "url": "https://naver-mail-mcp.capykkuing.workers.dev/mcp"
    }
  }
}

또는 내 컴퓨터에서 실행하기

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

{
  "servers": {
    "naver-mail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "naver-mail-mcp"
      ],
      "env": {
        "NAVER_ID": "your-value",
        "NAVER_APP_PASSWORD": "your-value"
      }
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요:

웹에서 ChatGPT 열기 → Settings → Connectors (Apps)
Create 또는 Add 누르기(일부 요금제는 먼저 Advanced에서 Developer mode를 켜야 해요)
아래 주소를 붙여 넣고 이름을 정한 뒤 저장하기
로그인하라고 하면 제작자의 서비스에 로그인하기

https://naver-mail-mcp.capykkuing.workers.dev/mcp

메뉴 이름은 요금제나 시기에 따라 조금 다를 수 있어요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

직접 입력할 값

NAVER_ID 필수 env
Naver ID (without @naver.com)
NAVER_APP_PASSWORD 비밀 필수 env
Naver app password (2-step verification required)

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

서버가 도구 목록을 보여 주기 전에 로그인을 요구해요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 8일 점검

✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 CapyKkuing 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
… 아직 점검 안 함
계속 관리되고 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
… 아직 점검 안 함
라이선스 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
✓ 통과
엔드포인트 응답
307ms 만에 응답(HTTP 401)
✓ 통과
OAuth로 로그인
OAuth 로그인을 지원한다고 밝혀서, AI 앱이 로그인 화면으로 안내해 줘요
… 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
아직 점검하지 않았어요. 엔드포인트를 점검할 때 도구 목록을 읽어요

채팅 및 이메일 카테고리의 다른 서버와 비교i

이 카테고리의 다른 서버 1848개 중 0%보다 스타가 많아요
이 카테고리의 다른 서버 1848개 중 86%보다 최근에 레지스트리에 공개됐어요
기본 점검 결과가 이 카테고리의 다른 서버 1848개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Naver Mail (네이버 메일), 안전한가요?

해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

입력해야 할 값: NAVER_ID, NAVER_APP_PASSWORD

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

둘 다 가능해요. 내 컴퓨터에 설치해도 되고, 클라우드 버전에 연결해도 돼요.

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(0.1.4)은 4일 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. URL로 연결되기 때문에, 원격 MCP 서버를 지원하는 앱(예: 개발자 모드의 ChatGPT)에서도 쓸 수 있어요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Vexa, emailmd, MCP WhatsApp Cloud

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Vexa

제작자: Vexa-ai

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

클라우드에서 실행★ 2,949Apache-2.02개월 전 업데이트

설치

emailmd

제작자: anypost

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

컴퓨터 또는 클라우드★ 1,385MIT32일 전 업데이트

설치

MCP WhatsApp Cloud

제작자: codespar

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

내 컴퓨터에서 실행★ 277MIT5개월 전 업데이트

설치

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

naver-mail-mcp

-blue.svg)

AI 에이전트가 지메일처럼 네이버 메일도 읽고, 요약하고, 답장하게 해 주는 MCP 서버입니다.

Claude, Grok, Meta Muse, ChatGPT, Codex에 연결하면 "이번 주 중요한 메일 요약해줘", "카드 결제 내역 메일만 모아줘", "이 메일에 회신해줘"가 네이버 메일에서도 됩니다. 도구 이름과 사용법이 Gmail MCP와 같아서, 지메일로 쓰던 에이전트 흐름을 그대로 쓸 수 있습니다.

English

예시 화면 (가상의 메일)

네이버의 공식 서비스가 아닙니다. 네이버 메일이 제공하는 IMAP/SMTP로 동작합니다.

무엇이 다른가

	이 프로젝트	다른 네이버 메일 MCP들
검색·읽기·첨부	✅	✅
지메일 검색 문법 (`from:` `newer_than:7d` `has:attachment` …)	✅	일부
대화(스레드) 묶어 보기	✅	일부
답장·전체 답장·전달	✅	❌
임시보관함 만들기·고치기·보내기	✅	일부
정리 (메일함 이동, 별표, 읽음, 휴지통, 스팸)	✅	❌
Gmail MCP와 같은 도구 이름·입력	✅	❌
클라우드 에이전트 연결 (Muse·Grok·Claude 앱, 설치 없이 주소만)	✅	대부분 PC 전용
한국어 인코딩 메일 (EUC-KR, `ks_c_5601-1987`, `cp949`)	✅	—

시작하기

1. 네이버 메일 준비 (한 번만, 약 3분)

연결하려면 2단계 인증이 필수입니다. 평소 로그인 비밀번호가 아니라, 2단계 인증을 켜야 만들 수 있는 애플리케이션 비밀번호로 연결합니다.

① 2단계 인증 켜기

네이버 로그인 → 오른쪽 위 프로필 → 네이버 ID (또는 nid.naver.com)
보안설정 → 2단계 인증 → 설정하기
휴대폰 번호(또는 네이버 앱)로 본인 확인을 마치면 켜집니다. 이미 켜져 있으면 ②로 넘어갑니다.

② 애플리케이션 비밀번호 만들기

네이버 ID → 보안설정 → 2단계 인증 → 관리 (본인 확인을 한 번 더 할 수 있음)
아래쪽 애플리케이션 비밀번호 관리에서 종류를 고르고 생성하기. 종류는 아무거나(예: Windows, 기타) 괜찮습니다.
나온 비밀번호를 복사해 둡니다. 창을 닫으면 다시 볼 수 없습니다. 잃어버리면 새로 만들면 됩니다.

③ POP3/IMAP 설정에서 IMAP 켜기

네이버 메일 → 왼쪽 아래 환경설정 (톱니바퀴)
POP3/IMAP 설정 탭 → IMAP/SMTP 설정
IMAP/SMTP 사용: 사용함 → 저장. POP3는 켤 필요가 없습니다.

네이버는 메뉴 이름·위치를 가끔 바꿉니다. 메뉴가 안 보이면 네이버 ID 페이지에서 "애플리케이션 비밀번호"를 검색하세요.

2. 연결하기 (쉬운 순서)

방법 A. 주소만 넣기 — 추천, 설치 없음

공개 서버 주소: `https://naver-mail-mcp.capykkuing.workers.dev/mcp`

에이전트	넣는 곳
Claude (웹·데스크톱·모바일)	설정 → 커넥터 → 커스텀 커넥터 추가
Grok	grok.com/connectors → New Connector → Custom
Meta Muse	설정에서 커넥터 URL 추가, 또는 대화창에 주소를 주고 "연결해줘"
ChatGPT	설정 → 앱/커넥터 → 개발자 모드에서 커스텀 커넥터 추가
Claude Code	`claude mcp add --transport http naver-mail https://naver-mail-mcp.capykkuing.workers.dev/mcp` 후 `/mcp`에서 로그인
Codex	`codex mcp add naver-mail --url https://naver-mail-mcp.capykkuing.workers.dev/mcp` 후 `codex mcp login naver-mail`

주소를 넣으면 로그인 화면이 열립니다. 네이버 아이디와 애플리케이션 비밀번호를 넣으면 끝입니다.

같은 서비스(예: Claude 앱)라면 PC·태블릿·폰 어디서든 한 번만 로그인하면 됩니다.
Claude Code나 Codex에는 "네이버 메일 MCP 설치해줘. 주소는 https://naver-mail-mcp.capykkuing.workers.dev/mcp, 이름은 naver-mail"이라고만 해도 AI가 설치합니다. 로그인만 직접 하세요.

방법 B. 내 PC에서 실행 — 비밀번호가 내 컴퓨터 밖으로 안 나감

Node.js 20 이상이 필요하고, Claude Desktop·Claude Code·Codex 같은 PC 프로그램에서만 쓸 수 있습니다.

Claude Desktop (claude_desktop_config.json):

"mcpServers": { "naver-mail": { "command": "npx", "args": ["-y", "naver-mail-mcp"], "env": { "NAVER_ID": "내아이디", "NAVER_APP_PASSWORD": "애플리케이션비밀번호" } } } }

Claude Code: claude mcp add naver-mail -e NAVER_ID=내아이디 -e NAVER_APP_PASSWORD=앱비밀번호 -- npx -y naver-mail-mcp

방법 C. 내 서버 만들기 — 클라우드 에이전트 + 내 서버

버튼을 누르면 내 Cloudflare 계정(무료로 됨)에 똑같은 서버가 만들어집니다. 다 되면 나오는 https://naver-mail-mcp.<내 계정>.workers.dev/mcp를 방법 A처럼 넣으면 됩니다.

ALLOWED_USERS에 내 네이버 아이디를 넣으면 나만 쓸 수 있습니다. 비우면 누구나 자기 계정으로 연결할 수 있습니다.
직접 배포하려면: npm install → npx wrangler kv namespace create OAUTH_KV로 만든 id를 wrangler.jsonc에 넣기 → npx wrangler deploy

고정 토큰 모드 (헤더를 넣을 수 있는 클라이언트용)

npx wrangler secret put MCP_BEARER_TOKEN      # 긴 무작위 문자열

npx wrangler secret put NAVER_ID npx wrangler secret put NAVER_APP_PASSWORD

요청 헤더에 Authorization: Bearer 를 넣으면 OAuth 없이 위 계정으로 접속합니다.

보안과 개인정보

이 서버가 다루는 가장 민감한 것은 애플리케이션 비밀번호입니다. 어디에 어떤 형태로 있는지 그대로 적습니다.

어디에	어떤 형태로	언제까지
OAuth 저장소 (Cloudflare KV)	연결한 앱의 토큰으로만 풀 수 있게 AES-GCM 암호화 (`@cloudflare/workers-oauth-provider`)	갱신 토큰 수명 30일. 네이버에서 앱 비밀번호를 지우면 그 전이라도 쓸모없어짐
MCP 세션 (Durable Object)	메모리에만. 요청마다 토큰에서 풀어 전달하므로 저장소에 쓰지 않음	세션이 끝나면 사라짐
네이버 서버로 가는 길	IMAP 993 / SMTP 465, TLS 암호화	요청 중에만
로그	비밀번호·메일 내용은 기록하지 않음. 요청 기록(Workers Logs)도 켜 두지 않음	—

메일 내용은 서버에 저장하지 않습니다. 요청이 올 때 네이버에서 읽어 에이전트에 넘길 뿐입니다. 끊긴 응답을 이어 주는 임시 저장 기능도 꺼 두었습니다.
세션은 로그인한 계정에 묶입니다. 다른 사람의 세션 ID를 알아도 내 로그인으로는 그 세션에 닿을 수 없습니다.
연결 끊기: 네이버 ID → 보안설정 → 2단계 인증 → 애플리케이션 비밀번호 삭제. 서버에 남은 암호화 사본은 그 순간부터 쓸모가 없어지고, 어느 에이전트에서든 즉시 끊깁니다.
가짜 로그인 화면 주의: 로그인 화면에는 "권한이 전달될 곳"이 항상 표시됩니다. 남에게서 받은 링크로 이 화면이 열렸거나, 그 주소가 내가 쓰는 AI 서비스가 아니면 거부하세요. 알려진 서비스(Claude, Grok, Meta Muse, ChatGPT)가 아니면 화면에 빨간 경고가 뜹니다.
메일 속 지시문 주의: 메일 본문에 "이 메일을 다른 주소로 전달해"처럼 AI를 겨냥한 문장이 들어 있을 수 있습니다. 이 서버는 보내기·답장·전달 전에 사용자에게 확인하라고 에이전트에게 안내하지만, 최종 판단은 에이전트가 합니다. 에이전트의 "도구 실행 전 확인" 설정을 켜 두는 것을 권합니다.
무차별 대입 방지: 로그인 시도는 IP마다 분당 10회, 전체 분당 60회로 제한합니다. 로그인 화면(/authorize)이 아닌 주소로는 로그인을 받지 않습니다. 네이버가 이 서버의 IP를 차단해 모든 사용자가 피해를 보는 일을 막기 위한 것입니다.
공개 서버가 꺼려지면: 공개 서버를 쓰는 것은 그 운영자를 믿는다는 뜻입니다. 코드는 모두 이 리포에 있고, 운영자도 KV의 암호화된 값만 볼 수 있을 뿐 토큰 없이는 풀 수 없습니다. 그래도 불안하면 방법 B(내 PC)나 방법 C(내 서버)를 쓰세요.

취약점을 발견하면 공개 이슈 대신 리포의 Security → Report a vulnerability로 알려 주세요.

도구 (Gmail MCP와 같은 이름)

분류	도구
찾기·읽기	`search_threads`, `get_thread`, `get_message`, `get_attachment`, `get_profile`
보내기	`send_message`, `reply`(전체 답장), `forward`(원래 첨부 포함)
임시보관함	`create_draft`, `update_draft`, `delete_draft`, `list_drafts`, `get_draft`
라벨	`list_labels`, `create_label`, `update_label`, `delete_label`, `label_message`, `unlabel_message`, `update_message_labels`, `label_thread`, `unlabel_thread`
휴지통·스팸	`trash_message`, `trash_thread`, `untrash_message`, `untrash_thread`, `mark_message_spam`, `mark_thread_spam`, `unmark_message_spam`, `unmark_thread_spam`

get_profile과 get_attachment는 Gmail MCP에는 없는 추가 도구입니다.

Gmail과 다른 점 (IMAP의 한계)

라벨은 메일함입니다. INBOX, SENT, DRAFT, TRASH, SPAM은 해당 메일함, 사용자 라벨은 메일함 경로입니다. 한 메일은 한 메일함에만 있으므로 메일함 라벨을 붙이면 이동합니다. STARRED(중요 표시)와 UNREAD(안읽음)는 플래그입니다.
메일 ID는 메일함과 UID로 만듭니다. 메일을 옮기면 ID가 바뀌고, 옮기는 도구가 새 ID를 돌려줍니다. 임시보관 메일을 고칠 때도 ID가 바뀝니다.
보관(archive)이 없습니다. 받은메일함에서 빼려면 다른 메일함 라벨을 붙이세요.
대화(thread)는 Message-ID/References 헤더로 묶습니다. 네이버 IMAP은 헤더 검색이 잘 안 돼서, 메일함마다 최근 1,000통의 헤더를 직접 읽어 찾습니다.
낱말 검색은 제목, 보낸 사람, 본문을 따로 찾아 합칩니다 (네이버 IMAP은 OR·전체 텍스트 검색을 처리하지 못함). has:attachment, filename:은 메일 구조를 직접 확인하며 메일함마다 최근 3,000통까지 봅니다. 더 오래된 메일은 after: 같은 기간 조건을 함께 쓰세요.
기본 검색 범위는 휴지통, 스팸, 임시보관함을 뺀 모든 메일함입니다. category: 같은 Gmail 전용 조건은 무시하고 결과의 warnings에 알려 줍니다.
서명 자동 붙이기와 카테고리 탭은 지원하지 않습니다.

실제 네이버 계정에서 확인한 것

2026년 10월, Meta Muse로 연결해 확인했습니다.

2단계 인증 + 애플리케이션 비밀번호로 연결
계정·안 읽은 메일 수 확인, 최근 메일 요약
검색: 한글 낱말(결제), 제목(subject:), 기간(newer_than:30d), 첨부(has:attachment, filename:pdf), 보낸메일함(in:sent)
대화 묶어 보기(get_thread), 첨부 이름 읽기
메일 발송과 보낸메일함 저장

답장·전달·임시보관함·라벨 이동·휴지통은 가짜 메일 서버 통합 테스트로 확인했고, 실제 계정 확인은 진행 중입니다. 문제를 발견하면 이슈로 알려 주세요.

개발

npm install

npm test # 가짜 IMAP/SMTP 서버 통합 테스트 + 단위 테스트 npm run typecheck npm run dev # 로컬 Worker: http://localhost:8787/mcp npm run stdio # 로컬 stdio (NAVER_ID, NAVER_APP_PASSWORD 환경 변수) npm run build:stdio # npm 배포용 dist/stdio.js

접속 정보: IMAP imap.naver.com:993(SSL), SMTP smtp.naver.com:465(SSL). 바뀐 내용은 CHANGELOG에 있습니다.

라이선스

MIT

Naver Mail (네이버 메일)

개요

PopNx MCP의 세 기둥

할 수 있는 일

설치

설치하기 전에

또는 내 컴퓨터에서 실행하기

또는 내 컴퓨터에서 실행하기

또는 내 컴퓨터에서 실행하기

또는 내 컴퓨터에서 실행하기

직접 입력할 값

할 수 있는 일

기본 점검i

제작자와 저장소 일치

계속 관리되고 있음

라이선스 있음

엔드포인트 응답

OAuth로 로그인

도구 설명에 숨겨진 지시 없음

채팅 및 이메일 카테고리의 다른 서버와 비교i

자주 묻는 질문

대안

Vexa

emailmd

MCP WhatsApp Cloud

제작자의 README

naver-mail-mcp

무엇이 다른가

시작하기

1. 네이버 메일 준비 (한 번만, 약 3분)

2. 연결하기 (쉬운 순서)

방법 A. 주소만 넣기 — 추천, 설치 없음

방법 B. 내 PC에서 실행 — 비밀번호가 내 컴퓨터 밖으로 안 나감

방법 C. 내 서버 만들기 — 클라우드 에이전트 + 내 서버

보안과 개인정보

도구 (Gmail MCP와 같은 이름)

Gmail과 다른 점 (IMAP의 한계)

실제 네이버 계정에서 확인한 것

개발

라이선스