Mufi Email Manager

한국형 이메일 통합 관리 도구. Gmail, 네이버, 다음, 카카오 메일을 IMAP/SMTP로 통합 관리. 읽지 않은 메일 요약, 키워드 필터링, 자동 답장, 일일 다이제스트 생성.

Security Scan

The package behaves like an IMAP/SMTP email manager (which justifies asking for email credentials), but the registry metadata, install spec, and runtime instructions are inconsistent and some referenced scripts are missing — review before installing or supplying credentials.

Purpose & Capability

The skill's name and description match the code: it connects to IMAP/SMTP, summarizes, filters, and replies. However, the registry metadata claims no required environment variables or install steps while SKILL.md and the code expect many account credentials (GMAIL_*, NAVER_*, DAUM_*, KAKAO_*), a .env file, and an npm install. That mismatch (metadata says none, runtime needs many secrets) is an incoherence.

Instruction Scope

SKILL.md instructs creating a .env with many credentials and running several scripts. The included scripts implement checking, filtering, summarizing, and replying — which is consistent. However, SKILL.md references additional commands/scripts (node scripts/digest.js, send.js, search.js) that are not present in the provided file manifest, creating a gap between documentation and code. Also lib/config.js loads .env from ../../.env (repository root), which may be unexpected and increases the risk of accidental credential commits if .gitignore is not configured.

Install Mechanism

There is no formal install spec in the registry, but a package.json and SKILL.md recommend running npm install. The dependencies are standard (imap, mailparser, nodemailer, dotenv) from the public npm registry — moderate but expected risk. The absence of an explicit install block in the registry metadata is inconsistent with the presence of code and package.json.

Credentials

The skill legitimately needs IMAP/SMTP credentials to operate, but the registry claims no required env vars or primary credential. That omission is important: users would not be warned that they must provide plaintext account passwords (or app-specific passwords). The code expects many sensitive env vars (username/password for multiple providers); requesting multiple unrelated account credentials is proportionate to the stated purpose only if the user intends to manage multiple accounts, but it must be explicit. The advice to add .env to .gitignore is present, but the tool still requires storing secrets locally in plaintext if used as-is.

Persistence & Privilege

The skill does not request 'always: true' nor attempt to modify other skills or system-wide settings. It operates as normal command-line scripts and does not request elevated persistence or platform-level privileges.

What to consider before installing

This package is an on-premises IMAP/SMTP email manager and the code matches the described features, but there are several red flags you should consider before installing or providing credentials: - The registry metadata declares no required env vars, but SKILL.md and the code require many email account credentials (GMAIL_*, NAVER_*, DAUM_*, KAKAO_*). Do not provide passwords to a skill whose metadata omits this requirement without verification of the publisher. - SKILL.md references scripts (digest.js, send.js, search.js) that are not included in the file list. Confirm the repository is complete and maintained, or ask the author for the missing files. - The project expects a .env at ../../.env (repo root). Ensure you add .env to .gitignore before creating it to avoid accidentally committing secrets. - Prefer using app-specific passwords or OAuth flows (especially for Gmail) rather than your primary account password. This code uses basic username/password auth for IMAP/SMTP which may require app passwords for some providers. - Review the code locally (you already have all source files) and run npm install in an isolated environment (container or VM) if you want to test. Check network activity if you are concerned about exfiltration — this repo only uses IMAP/SMTP and does not contain obvious remote exfil endpoints, but mismatched metadata and missing files are a sign to be cautious. If you plan to use it, verify the missing scripts, confirm the author/source, and only use account credentials you are willing to expose to a local tool (or better, use app-specific credentials).

한국 주요 이메일 서비스(Gmail, 네이버, 다음, 카카오)를 통합 관리하는 IMAP/SMTP 기반 도구입니다.

주요 기능

• 📬 다중 계정 통합: Gmail, 네이버, 다음, 카카오 메일 동시 관리
• 📊 스마트 요약: 읽지 않은 메일 자동 요약 및 분류
• 🔍 키워드 필터링: 중요 메일 자동 탐지 (업무, 결제, 보안 등)
• 🤖 자동 답장: 템플릿 기반 빠른 답장
• 📰 일일 다이제스트: 하루 메일 요약 리포트 생성

설정

환경 변수 설정

스킬 폴더에 .env 파일을 생성하거나 환경 변수로 설정:

# 기본 계정 (필수)
DEFAULT_ACCOUNT=gmail  # gmail, naver, daum, kakao 중 선택

# Gmail 계정
GMAIL_USER=[e-mail]
GMAIL_PASS=your_app_password
GMAIL_IMAP_HOST=imap.gmail.com
GMAIL_IMAP_PORT=993
GMAIL_SMTP_HOST=smtp.gmail.com
GMAIL_SMTP_PORT=587

# 네이버 메일
NAVER_USER=[e-mail]
NAVER_PASS=your_password
NAVER_IMAP_HOST=imap.naver.com
NAVER_IMAP_PORT=993
NAVER_SMTP_HOST=smtp.naver.com
NAVER_SMTP_PORT=587

# 다음(Daum) 메일
DAUM_USER=[e-mail]
DAUM_PASS=your_password
DAUM_IMAP_HOST=imap.daum.net
DAUM_IMAP_PORT=993
DAUM_SMTP_HOST=smtp.daum.net
DAUM_SMTP_PORT=465

# 카카오(Kakao) 메일
KAKAO_USER=[e-mail]
KAKAO_PASS=your_password
KAKAO_IMAP_HOST=imap.kakao.com
KAKAO_IMAP_PORT=993
KAKAO_SMTP_HOST=smtp.kakao.com
KAKAO_SMTP_PORT=465

# 필터 키워드 (쉼표로 구분)
IMPORTANT_KEYWORDS=결제,청구,납부,계약,승인,보안,비밀번호,urgent,invoice
SPAM_KEYWORDS=광고,홍보,이벤트,쿠폰,할인

# 다이제스트 설정
DIGEST_ENABLED=true
DIGEST_TIME=09:00
DIGEST_RECIPIENTS=[e-mail]

한국 이메일 서버 정보

서비스	IMAP 서버	IMAP 포트	SMTP 서버	SMTP 포트	비고
Gmail	imap.gmail.com	993	smtp.gmail.com	587	2단계 인증 시 앱 비밀번호 필요
네이버	imap.naver.com	993	smtp.naver.com	587	IMAP/SMTP 설정 활성화 필요
다음	imap.daum.net	993	smtp.daum.net	465	SSL 사용
카카오	imap.kakao.com	993	smtp.kakao.com	465	SSL 사용
한메일	imap.daum.net	993	smtp.daum.net	465	다음과 동일

중요:

• Gmail: 2단계 인증 사용 시 앱 비밀번호 필수
• 네이버: 메일 설정에서 IMAP/SMTP 사용 설정 필요
• 다음/카카오: SMTP 포트 465 (SSL 직접 연결)

명령어

1. 통합 메일 확인

모든 계정의 읽지 않은 메일 확인:

node scripts/check-all.js [--limit 20]

특정 계정만 확인:

node scripts/check.js --account gmail [--limit 10]
node scripts/check.js --account naver [--limit 10]

2. 스마트 요약

읽지 않은 메일을 키워드 기반으로 분류하여 요약:

node scripts/summary.js [--account gmail] [--recent 24h]

출력 예시:

📬 읽지 않은 메일 요약 (Gmail)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔴 중요 (3건)
  - [결제] 카드 승인 내역 안내 (신한카드)
  - [보안] 새로운 기기에서 로그인 시도 (Google)
  - [업무] 프로젝트 마감 알림 (팀장님)

🟡 일반 (12건)
  - 주간 뉴스레터 (Tech News)
  - 배송 완료 알림 (쿠팡)
  ...

🔵 읽을만한 (5건)
  - 친구 초대장 (Facebook)
  ...

3. 중요 메일 필터링

키워드로 중요 메일만 추출:

node scripts/filter.js --keywords "결제,청구,승인" [--account all] [--recent 7d]

4. 자동 답장

템플릿 기반 빠른 답장:

# 템플릿 목록
node scripts/reply.js --list

# 템플릿 사용
node scripts/reply.js --uid 12345 --template thanks --account gmail

# 커스텀 답장
node scripts/reply.js --uid 12345 --body "감사합니다." --account gmail

기본 템플릿:

• thanks: 감사 인사
• confirm: 확인 완료
• meeting: 미팅 일정 조율
• ooo: 부재중 자동 응답

5. 일일 다이제스트

하루 메일 요약 리포트 생성:

node scripts/digest.js [--date 2026-02-16] [--accounts gmail,naver]

출력 형식:

• 텍스트 리포트
• HTML 이메일로 전송 옵션
• JSON 형식 지원

6. 메일 발송

통합 발송 인터페이스:

node scripts/send.js \
  --account gmail \
  --to [e-mail] \
  --subject "안녕하세요" \
  --body "메일 본문입니다." \
  [--attach file.pdf]

7. 검색

모든 계정에서 통합 검색:

node scripts/search.js \
  --query "프로젝트" \
  [--accounts gmail,naver] \
  [--recent 30d] \
  [--limit 50]

템플릿 커스터마이징

scripts/templates.json 파일에서 답장 템플릿 수정 가능:

{
  "thanks": {
    "subject": "Re: {original_subject}",
    "body": "안녕하세요,\n\n메일 감사합니다.\n확인 후 회신 드리겠습니다.\n\n감사합니다."
  },
  "confirm": {
    "subject": "Re: {original_subject}",
    "body": "확인 완료했습니다.\n추가 문의 사항 있으시면 연락 주세요."
  }
}

크론 작업 예시

매일 아침 9시 다이제스트 발송:

0 9 * * * cd /path/to/mufi-email-manager && node scripts/digest.js --send

30분마다 중요 메일 체크:

*/30 * * * * cd /path/to/mufi-email-manager && node scripts/filter.js --keywords "긴급,urgent" --notify

설치

cd skills/mufi-email-manager
npm install

보안 주의사항

• .env 파일을 .gitignore에 추가
• Gmail은 앱 비밀번호 사용 권장
• 비밀번호를 코드에 하드코딩하지 말 것
• 중요 메일은 자동 삭제하지 않도록 주의

트러블슈팅

연결 실패:

• 서버 주소와 포트 확인
• 방화벽 설정 확인

인증 실패:

• 이메일 주소와 비밀번호 재확인
• Gmail: 앱 비밀번호 사용 여부 확인
• 네이버: IMAP/SMTP 설정 활성화 여부 확인

TLS/SSL 에러:

• 다음/카카오는 SMTP 포트 465 (SSL 직접 연결)
• Gmail/네이버는 SMTP 포트 587 (STARTTLS)

라이센스

MIT