MCP 服务器

Email MCP Server

This MCP server enables users to manage emails via POP3 and SMTP protocols, allowing for listing, searching, reading, and sending messages. It also supports fetching email threads and extracting text content from various document attachments including PDFs and Office files.

README

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	이메일 발송