better-email-mcp은(는) 무엇을 하나요?
AI 에이전트를 위한 IMAP/SMTP 이메일 서버 — 6개의 복합 도구, 다중 계정 및 자동 검색 지원
개요
better-email-mcp는 AI 에이전트가 이메일 작업을 수행할 수 있도록 IMAP/SMTP를 추상화하는 MCP 서버입니다. 이메일 전송, 수신, 검색, 폴더 관리 등 6개의 복합 도구를 제공하며, 여러 계정을 동시에 지원하고 자동 검색(auto-discovery) 기능으로 설정 절차를 최소화합니다.
주요 기능
- 다중 계정 지원: IMAP/SMTP 자격 증명을 사용하여 여러 이메일 계정을 동시에 연결할 수 있습니다.
- 자동 검색: 도메인 기반 IMAP/SMTP 서버 설정을 자동으로 감지합니다.
- 6개의 복합 도구: 이메일 전송, 읽기, 검색, 폴더 관리, 계정 정보 조회 등의 작업을 수행합니다.
- MCP 프로토콜: AI 에이전트(Claude Code, Cursor, Codex 등)와 호환됩니다.
지원 도구
| 도구 이름 | 설명 |
|---|---|
send_email | SMTP를 통해 이메일 전송 (첨부 파일 지원) |
read_email | 특정 이메일의 본문 및 헤더 읽기 |
search_emails | 키워드, 발신자, 날짜 등으로 이메일 검색 |
list_folders | IMAP 폴더(라벨) 목록 조회 |
move_email | 이메일을 다른 폴더로 이동 |
get_account_info | 현재 연결된 계정 정보 확인 |
설치 및 설정
필수 조건
- Node.js 18 이상
- IMAP/SMTP를 지원하는 이메일 계정 (Gmail, Outlook, 사용자 지정 서버 등)
설치
npm install n24q02m/better-email-mcp
환경 변수 설정
계정 자격 증명은 환경 변수나 .env 파일을 통해 관리합니다.
EMAIL_SERVER=smtp.gmail.com
EMAIL_PORT=587
[email protected]
EMAIL_PASS=your-app-password
IMAP_SERVER=imap.gmail.com
IMAP_PORT=993
MCP 클라이언트 설정
claude_desktop_config.json 또는 유사한 설정 파일에서:
{
"mcpServers": {
"better-email": {
"command": "npx",
"args": ["-y", "@n24q02m/better-email-mcp"],
"env": {
"EMAIL_SERVER": "smtp.gmail.com",
"EMAIL_PORT": "587",
"EMAIL_USER": "[email protected]",
"EMAIL_PASS": "your-app-password",
"IMAP_SERVER": "imap.gmail.com",
"IMAP_PORT": "993"
}
}
}
}
사용 예시
AI 에이전트 내에서 다음과 같은 명령어로 이메일 작업을 수행할 수 있습니다.
- 이메일 보내기:
send_email to="[email protected]" subject="안녕하세요" body="테스트 이메일입니다." - 받은 편지함 검색:
search_emails query="회의" folder="INBOX" - 이메일 읽기:
read_email uid=12345
주의사항
- Gmail을 사용하는 경우 앱 비밀번호가 필요합니다.
- 보안을 위해 자격 증명은 환경 변수로 관리하는 것을 권장합니다.
- 대량 이메일 전송은 서비스 약관에 위배될 수 있으므로 주의하세요.
라이선스
MIT