# 네이버웍스 메일 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. 패키지 설치

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

### 3. .env 파일 설정

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

```bash
cp .env.example .env
```

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

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

## Claude Desktop 연동

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

```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 에게 "안녕하세요" 제목으로 메일 보내줘
```