네이버웍스 메일 MCP 서버

Claude Desktop에서 네이버웍스 메일을 읽고 보낼 수 있는 MCP 서버입니다.

제공 기능

Tool	설명
list_emails	받은편지함 최근 메일 조회
list_unread_emails	읽지 않은 메일만 조회
list_emails_from	특정 발신자 메일 조회
get_email	메일 ID로 특정 메일 전체 내용 조회
search_emails	제목 키워드로 메일 검색
send_email	메일 발송

사전 준비

1. 외부 앱 비밀번호 발급

네이버웍스 IMAP/SMTP 연동에는 로그인 비밀번호가 아닌 외부 앱 전용 비밀번호가 필요합니다.

1. 네이버웍스 접속 후 우측 상단 프로필 → 환경설정
2. 좌측 메뉴에서 보안 클릭
3. 외부 앱 비밀번호 섹션 → 외부 앱 비밀번호 생성하기 클릭
4. 새 비밀번호 생성 버튼 클릭
5. 앱 이름 입력 (예: openclaw) 후 생성
6. 화면에 표시되는 비밀번호를 복사해서 보관 (다시 확인 불가)

⚠️ 생성된 비밀번호는 생성 시에만 확인 가능합니다. 반드시 복사해두세요.

2. 패키지 설치

cd /path/to/naverworks-mail-mcp
pip install -r requirements.txt

3. .env 파일 설정

.env.example을 복사해서 .env 파일을 만들고 아래 정보를 입력합니다.

cp .env.example .env

NAVER_EMAIL="본인계정@도메인.com"
NAVER_APP_PASSWORD="외부앱에서_발급받은_비밀번호"

• NAVER_EMAIL: 네이버웍스 로그인 이메일 주소
• NAVER_APP_PASSWORD: 위에서 발급한 외부 앱 비밀번호 (로그인 비밀번호 아님)

Claude Desktop 연동

~/Library/Application Support/Claude/claude_desktop_config.json에 아래 내용을 추가합니다.

{
  "mcpServers": {
    "naver-works-mail": {
      "command": "python3",
      "args": ["/path/to/naverworks-mail-mcp/server.py"]
    }
  }
}

설정 후 Claude Desktop을 완전히 종료 후 재시작하면 적용됩니다.

사용 예시

Claude에게 자연어로 요청하면 됩니다.

최근 메일 5개 보여줘
안 읽은 메일 있어?
kim@example.com 이 보낸 메일 찾아줘
subject에 "견적" 들어간 메일 검색해줘
hong@example.com 에게 "안녕하세요" 제목으로 메일 보내줘