快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

uvx naver-mail-mcp

详细介绍

naver-mail-mcp

Naver Mail MCP Server for Claude Desktop.

네이버 메일을 Claude Desktop에서 Gmail MCP처럼 사용할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다.

Features

Tool	Description
`get_profile`	계정 프로필 조회 (이메일, 이름, 총 메일 수, 안읽은 수)
`search_emails`	메일 검색 (발신자, 수신자, 제목, 날짜, 읽음 여부) + 페이지네이션
`read_email`	UID로 메일 전체 읽기 (헤더, 본문, 첨부파일 메타정보)
`read_thread`	Message-ID 기반 대화 스레드 조회
`list_folders`	메일함 폴더 목록 조회 (메시지 수, 안읽은 수 포함)
`create_draft`	새 메일 초안을 Drafts 폴더에 저장
`list_drafts`	Drafts 폴더의 초안 목록 조회
`send_email`	SMTP로 메일 발송 (새 메일, 답장)
`download_attachment`	첨부파일 다운로드 (base64 인코딩)

Installation

uvx naver-mail-mcp

Claude Desktop Configuration

PyPI 배포 후 (권장)

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "naver-email": {
      "command": "uvx",
      "args": ["naver-mail-mcp"],
      "env": {
        "NAVER_EMAIL_ADDRESS": "your_email@naver.com",
        "NAVER_EMAIL_PASSWORD": "your_app_password",
        "NAVER_FULL_NAME": "Your Name"
      }
    }
  }
}

로컬 개발 모드

PyPI에 배포하기 전, 로컬 소스에서 직접 실행:

{
  "mcpServers": {
    "naver-email": {
      "command": "/absolute/path/to/uv",
      "args": [
        "--directory",
        "/absolute/path/to/naver-mail-mcp",
        "run",
        "naver-mail-mcp"
      ],
      "env": {
        "NAVER_EMAIL_ADDRESS": "your_email@naver.com",
        "NAVER_EMAIL_PASSWORD": "your_app_password",
        "NAVER_FULL_NAME": "Your Name"
      }
    }
  }
}

주의: Claude Desktop은 시스템 PATH를 상속하지 않습니다. command에는 반드시 uv의 절대 경로를 사용하세요. (예: /Users/username/.local/bin/uv) which uv 명령으로 절대 경로를 확인할 수 있습니다.

Prerequisites

Python 3.10+
네이버 계정에서 IMAP/SMTP 사용 설정

- 네이버 메일 → 설정 → POP3/IMAP 설정 → IMAP/SMTP 사용 ✅

애플리케이션 비밀번호 발급 (2단계 인증 필수)

- 네이버 → 내 정보 → 보안설정 → 2단계 인증 → 애플리케이션 비밀번호 관리

Environment Variables

Variable	Required	Description
`NAVER_EMAIL_ADDRESS`	Yes	네이버 이메일 주소
`NAVER_EMAIL_PASSWORD`	Yes	애플리케이션 비밀번호 (계정 비밀번호 아님)
`NAVER_FULL_NAME`	No	발신 메일 표시 이름

Tools Reference

get_profile

계정 프로필 조회. 파라미터 없음.

search_emails

Parameter	Type	Required	Default	Description
folder	string	No	INBOX	검색할 폴더
sender	string	No	-	발신자 필터
recipient	string	No	-	수신자 필터
subject	string	No	-	제목 키워드
date_from	string	No	-	시작 날짜 (DD-Mon-YYYY)
date_to	string	No	-	종료 날짜 (DD-Mon-YYYY)
is_read	boolean	No	-	읽음 여부 (true/false/null)
page	integer	No	1	페이지 번호
page_size	integer	No	20	페이지당 결과 수 (최대 100)

read_email

Parameter	Type	Required	Default	Description
uid	string	Yes	-	메일 고유 ID
folder	string	No	INBOX	폴더

read_thread

Parameter	Type	Required	Default	Description
message_id	string	Yes	-	Message-ID 헤더 값
folder	string	No	INBOX	폴더

list_folders

폴더 목록 조회. 파라미터 없음.

create_draft

Parameter	Type	Required	Default	Description
to	array	Yes	-	수신자 목록
subject	string	Yes	-	제목
body	string	Yes	-	본문
body_type	string	No	text/plain	text/plain 또는 text/html
cc	array	No	-	참조 목록

list_drafts

초안 목록 조회. 파라미터 없음.

send_email

Parameter	Type	Required	Default	Description
to	array	Yes	-	수신자 목록
subject	string	Yes	-	제목
body	string	Yes	-	본문
body_type	string	No	text/plain	text/plain 또는 text/html
cc	array	No	-	참조 목록
in_reply_to	string	No	-	답장 대상 Message-ID
references	array	No	-	스레드 Message-ID 목록

download_attachment

Parameter	Type	Required	Default	Description
uid	string	Yes	-	메일 고유 ID
part_number	string	Yes	-	MIME 파트 번호 (read_email에서 확인)
folder	string	No	INBOX	폴더

Development

# Clone and install
git clone https://github.com/chanmuzi/naver-mail-mcp.git
cd naver-mail-mcp
uv venv --python 3.12 .venv
source .venv/bin/activate
uv pip install -e .

# Set credentials
cp .env.example .env
# Edit .env with your credentials

# Run tests
python -m tests.test_integration

Troubleshooting

Error	Solution
`IMAP authentication failed`	앱 비밀번호 확인. 계정 비밀번호가 아닌 애플리케이션 비밀번호 사용
`Cannot connect to Naver IMAP server`	네트워크 확인, IMAP 사용 설정 확인
`Missing required environment variables`	NAVER_EMAIL_ADDRESS, NAVER_EMAIL_PASSWORD 환경변수 설정
`Folder not found`	`list_folders` 도구로 사용 가능한 폴더명 확인
`Failed to spawn process`	`command`에 `uv`의 절대 경로 사용 (`which uv`로 확인)

Technical Details

IMAP: imap.naver.com:993 (SSL/TLS)
SMTP: smtp.naver.com:465 (SSL)
Transport: stdio (Claude Desktop 연동)
Encoding: UTF-8, EUC-KR, Modified UTF-7 (폴더명) 자동 처리
Connection: 각 도구 호출마다 새 연결 (stateless)
Attachment limit: 10MB (base64 인코딩)

License

MIT

目录标签

邮件管理PythonClaude本地部署IMAP/SMTPClaudeDesktop自动化

支持客户端

Claude DesktopClaude

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

none

运行时（runtime，运行环境）

Python

工具数量（toolCount，工具数）

9

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdionone部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP World

mcpworld.com

/detail/164d5141df2037492477f3f0069845b2

Naver Mail MCP Server 是一个为Claude Desktop设计的邮件管理服务，支持邮件搜索、阅读、发送、草稿管理等功能。

继续浏览同类 MCP

更多办公协作 MCP（2,235）返回 MCP 目录

上一个 MCP

Nathanwolfe2208 MCP

一个用于将AI代理输出格式化为专业报告、电子邮件和文档的MCP服务器，适用于AI操作平台。

下一个 MCP

Naver Mail MCP Server

Mail MCP Server是一个邮件代理服务器，用于与Claude Desktop等客户端集成，提供邮件服务的代理功能。