README.md
Manage emails via POP3 and SMTP protocols in MCP clients.
Email MCP Server
POP3/SMTP 이메일 계정에 접근하는 MCP(Model Context Protocol) 서버입니다. Claude Desktop, Claude Code 등 MCP 클라이언트에서 이메일을 조회, 검색, 읽기, 발송할 수 있습니다.
설치
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`)
{
"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개 보여줘"
- "김철수한테 온 메일 찾아줘"
- "첫 번째 이메일 읽어줘"
- "오늘 받은 이메일 요약해줘"
- "첨부파일 내용 추출해줘"
Tools (8)
list_emailsList recent emails.search_emailsSearch emails by keyword.read_emailRead the full content of an email.fetch_recent_emailsFetch a batch of recent emails for summarization.fetch_email_threadRestore email threads based on the subject.download_attachmentDownload email attachments.read_attachment_textExtract text from attachments like pptx, docx, xlsx, and pdf.send_emailSend an email.Environment Variables
EMAIL_USERrequiredEmail account usernameEMAIL_PASSWORDrequiredEmail account passwordPOP3_HOSTPOP3 server hostPOP3_PORTPOP3 server port (SSL)SMTP_HOSTSMTP server hostSMTP_PORTSMTP server port (SSL)Configuration
claude_desktop_config.json
{"mcpServers": {"email": {"command": "node", "args": ["/absolute/path/to/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"}}}}Try it
→Show me my 10 most recent emails.
→Find emails sent by John Doe.
→Read the first email in my inbox.
→Summarize the emails I received today.
→Extract the text content from the attached PDF in the latest email.