# Email MCP Server

POP3/SMTP 이메일 계정에 접근하는 MCP(Model Context Protocol) 서버입니다.
Claude Desktop, Claude Code 등 MCP 클라이언트에서 이메일을 조회, 검색, 읽기, 발송할 수 있습니다.

## 설치

```bash
git clone https://github.com/jhw7500/email-mcp-server.git
cd email-mcp-server
npm install
npm run build
```

## 설정

MCP 클라이언트의 설정 파일에 다음을 추가하세요.

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "email": {
      "command": "node",
      "args": ["/절대경로/email-mcp-server/dist/index.js"],
      "env": {
        "EMAIL_USER": "your-email@example.com",
        "EMAIL_PASSWORD": "your-password",
        "POP3_HOST": "pop3.your-provider.com",
        "POP3_PORT": "995",
        "SMTP_HOST": "smtp.your-provider.com",
        "SMTP_PORT": "465"
      }
    }
  }
}
```

### Claude Code (`~/.claude/settings.json`)

설정 파일의 `mcpServers` 섹션에 위와 동일한 형식으로 추가합니다.

## 환경변수

| 변수 | 필수 | 기본값 | 설명 |
|------|------|--------|------|
| EMAIL_USER | O | - | 이메일 계정 |
| EMAIL_PASSWORD | O | - | 이메일 비밀번호 |
| POP3_HOST | X | pop3.hiworks.co.kr | POP3 서버 호스트 |
| POP3_PORT | X | 995 | POP3 서버 포트 (SSL) |
| SMTP_HOST | X | smtp.hiworks.co.kr | SMTP 서버 호스트 |
| SMTP_PORT | X | 465 | SMTP 서버 포트 (SSL) |

## 지원 메일 서비스

POP3/SMTP를 지원하는 모든 메일 서비스에서 사용 가능합니다:

| 서비스 | POP3_HOST | SMTP_HOST |
|--------|-----------|-----------|
| HiWorks | pop3.hiworks.co.kr | smtp.hiworks.co.kr |
| Gmail | pop.gmail.com | smtp.gmail.com |
| Naver | pop.naver.com | smtp.naver.com |
| Daum/Kakao | pop.daum.net | smtp.daum.net |

> Gmail은 앱 비밀번호 생성이 필요합니다.

## 제공 도구 (8개)

| 도구 | 설명 |
|------|------|
| list_emails | 최근 이메일 목록 조회 |
| search_emails | 키워드로 이메일 검색 |
| read_email | 이메일 전체 내용 읽기 |
| fetch_recent_emails | 최근 이메일 배치 조회 (요약용) |
| fetch_email_thread | 제목 기반 스레드 복원 |
| download_attachment | 첨부파일 다운로드 |
| read_attachment_text | 첨부파일 텍스트 추출 (pptx/docx/xlsx/pdf) |
| send_email | 이메일 발송 |

## 사용 예시

Claude에게 다음과 같이 요청하세요:

- "최근 이메일 10개 보여줘"
- "김철수한테 온 메일 찾아줘"
- "첫 번째 이메일 읽어줘"
- "오늘 받은 이메일 요약해줘"
- "첨부파일 내용 추출해줘"