Email 스킬 설정 가이드: 네이버·Google·Daum·Custom + 멀티 계정

itda-skills의 email 스킬을 사용하면 Claude Code 또는 Claude Cowork에서 자연어로 이메일을 보내고 읽을 수 있습니다. “이 메일 보내줘”, “회사 메일함 확인해줘”, “다음 메일 읽어줘”처럼 말이죠.

하지만 이 스킬이 동작하려면 이메일 계정 쪽에서 먼저 외부 앱 접근을 허용해줘야 합니다. 네이버, Google, Daum 모두 보안 정책상 일반 비밀번호로는 외부 앱 연동이 불가능하고, 2단계 인증을 켠 뒤 별도의 앱 비밀번호를 발급받아야 합니다.

이 글에서는 네이버 메일, Google (Gmail), Daum/Kakao, Custom SMTP/IMAP 네 가지 제공자의 설정 방법과, 멀티 계정 지원(예: 개인 Gmail + 회사 Gmail 동시 사용) 사용법을 정리합니다.

이 글이 필요한 분: Claude Cowork 또는 Claude Code에서 email 스킬을 처음 설정하는 분, 한 사람이 여러 이메일 계정을 운용하는 분, 또는 외부 메일 클라이언트에 주요 한국·글로벌 메일 서비스를 연동하려는 분

email 스킬이 필요로 하는 것

email 스킬은 내부적으로 SMTP(메일 발송)와 IMAP(메일 수신) 프로토콜을 사용합니다. 외부 앱에서 이메일을 보내려면 원래 서버 주소, 포트 번호, 보안 방식, 인증 정보 등 여러 설정이 필요하지만, email 스킬은 주요 제공자는 이메일 주소와 앱 비밀번호 두 가지만 알려주면 나머지를 전부 자동으로 처리합니다.

email 스킬이 자동으로 처리하는 것들: SMTP/IMAP 서버 주소 선택, 포트 번호(465/993), SSL 보안 연결, 제공자별 첨부파일 크기 제한(Gmail 25MB, 네이버 10MB) 검증, 차단 확장자 사전 필터링, SPF/DKIM/DMARC 피싱 신호 탐지, 연결 타임아웃 관리까지 — 여러분은 “누구에게 무엇을 보낼지”만 신경 쓰면 됩니다.

네이버, Google, Daum은 공통적으로 2단계 인증 활성화와 앱 비밀번호 발급이 필요합니다. Custom SMTP는 서버 운영 주체의 인증 정책을 따릅니다.

1. 네이버 메일 설정

네이버는 2025년 6월부터 POP3/IMAP/SMTP 접속 시 앱 비밀번호가 필수입니다. 일반 네이버 비밀번호로는 더 이상 외부 앱에서 메일을 사용할 수 없습니다.

Step 1: 2단계 인증 켜기

1. nid.naver.com에 로그인합니다.
2. 보안설정 메뉴로 이동합니다.
3. 2단계 인증 항목에서 설정하기를 클릭합니다.
4. 인증 수단(네이버 앱, OTP 등)을 선택하고 안내에 따라 설정을 완료합니다.

Step 2: 애플리케이션 비밀번호 생성

2단계 인증이 켜져 있어야 이 메뉴가 나타납니다.

1. nid.naver.com > 보안설정 > 2단계 인증 > 관리를 클릭합니다.
2. 하단의 애플리케이션 비밀번호 관리로 이동합니다.
3. 생성하기 버튼을 클릭합니다.
4. 종류에서 직접 입력을 선택하고, 이름을 입력합니다 (예: itda-email).
5. 생성 버튼을 클릭하면 비밀번호가 표시됩니다.
6. 즉시 복사합니다 — 이 비밀번호는 다시 확인할 수 없습니다.

주의: 생성된 비밀번호는 창을 닫으면 다시 볼 수 없습니다. 반드시 바로 복사하여 안전한 곳에 저장해두세요.

Step 3: IMAP/SMTP 사용 설정

네이버 메일에서 외부 앱 접근을 허용하는 설정입니다.

1. mail.naver.com에 접속합니다.
2. 좌측 하단의 환경설정(톱니바퀴 아이콘)을 클릭합니다.
3. POP3/IMAP 설정 메뉴를 선택합니다.
4. IMAP/SMTP 설정 탭을 클릭합니다.
5. IMAP/SMTP 사용을 사용함으로 변경합니다.
6. 확인을 클릭하여 저장합니다.

설정이 완료되면 네이버 메일의 SMTP/IMAP 서버 정보는 다음과 같습니다:

email 스킬은 서버 주소와 포트를 자동으로 설정하므로, 여러분은 이메일 주소와 앱 비밀번호만 환경변수에 입력하면 됩니다.

2. Google (Gmail) 설정

Google도 2024년부터 “보안 수준이 낮은 앱” 옵션이 완전히 제거되었습니다(소비자 계정 기준 6월, Workspace 기준 9월). 외부 앱에서 Gmail을 사용하려면 2단계 인증 + 앱 비밀번호가 유일한 방법입니다.

Step 1: 2단계 인증 켜기

1. myaccount.google.com에 로그인합니다.
2. 좌측 메뉴에서 보안을 클릭합니다.
3. “Google에 로그인하는 방법” 섹션에서 2단계 인증을 찾습니다.
4. 2단계 인증을 클릭하고 안내에 따라 설정합니다 (휴대전화 인증 등).

이미 2단계 인증이 켜져 있다면 이 단계는 건너뛰세요.

Step 2: 앱 비밀번호 생성

1. myaccount.google.com/apppasswords로 이동합니다.
   • 이 페이지는 2단계 인증이 켜져 있을 때만 접근 가능합니다.
2. 앱 이름을 입력합니다 (예: itda-email).
3. 만들기를 클릭합니다.
4. 16자리 비밀번호가 4글자씩 끊어서 표시됩니다.
5. 즉시 복사합니다 — 이 창을 닫으면 다시 확인할 수 없습니다.

Gmail IMAP 활성화 확인: Gmail 설정 > 전달 및 POP/IMAP > IMAP 액세스에서 ‘IMAP 사용’이 선택되어 있는지 확인하세요. 일반 Gmail 계정은 기본적으로 활성화되어 있습니다.

앱 비밀번호 메뉴가 보이지 않나요? 2단계 인증이 꺼져 있거나, Google Workspace 관리자가 앱 비밀번호를 비활성화한 경우입니다. 먼저 2단계 인증을 켜고, Workspace 계정이라면 관리자에게 문의하세요.

Google (Gmail)의 SMTP/IMAP 서버 정보는 다음과 같습니다:

email 스킬 vs Gmail MCP 커넥터

Claude의 내장 Gmail MCP 커넥터는 OAuth 기반 Gmail 접근을 제공하지만, 이메일 전송은 지원하지 않고(임시저장만 가능), 로그인에 브라우저가 필요합니다.

반면 email 스킬은 발송+수신을 하나의 도구로 제공하고, 헤드리스 환경(Cowork, CI/CD)에서도 동작하며 네이버·Google·Daum·Custom을 통합된 인터페이스로 다룰 수 있습니다.

3. Daum / Kakao 설정

Daum 메일은 @daum.net, @hanmail.net, @kakao.com 세 도메인을 같은 IMAP 서버로 서빙합니다. 카카오 계정으로 통합된 이후에도 Daum 메일 웹 인터페이스에서 설정합니다.

Step 1: IMAP 활성화 및 앱 비밀번호 발급

1. mail.daum.net에 접속합니다.
2. 좌측 하단의 환경설정을 클릭합니다.
3. IMAP/POP3 탭으로 이동한 뒤 IMAP을 선택합니다.
4. IMAP/SMTP 사용 필드에서 사용함을 체크합니다.
5. “앱 비밀번호를 확인해주세요.” 대화상자가 뜨면 [생성하기]를 클릭합니다.
6. member.daum.net/my/security로 이동되면 앱 비밀번호 메뉴를 클릭합니다.
7. 등록된 이메일 주소로 인증번호를 받아 본인 인증을 완료합니다.
8. 임의의 앱 이름을 입력하면 비밀번호가 자동 생성됩니다.
9. 생성된 비밀번호를 즉시 복사합니다.

발급된 앱 비밀번호는 2주 이내에 로그인하지 않으면 자동으로 삭제됩니다 발급 직후 email 스킬에 등록하고 연결 테스트까지 마치는 것을 권장합니다. 삭제되었다면 같은 절차로 다시 생성하면 됩니다.

Daum/Kakao 앱 비밀번호 특징 네이버·Google과 마찬가지로 앱별로 새 비밀번호를 발급하는 방식이지만, 발급 경로가 Daum 메일이 아닌 카카오 계정 보안 페이지(member.daum.net/my/security)라는 점이 다릅니다. 생성된 비밀번호를 DAUM_APP_PASSWORD에 넣으면 됩니다.

Daum 메일의 SMTP/IMAP 서버 정보:

세 도메인 모두 동일한 서버를 사용하므로 @kakao.com, @hanmail.net 계정도 동일한 설정으로 동작합니다.

4. Custom SMTP/IMAP 설정

회사 메일, 자체 메일 서버, 또는 Naver Works·Google Workspace·Microsoft 365 등 위 세 제공자에 해당하지 않는 경우에 사용합니다.

email 스킬은 Custom provider 설정 시 SMTP 4개 변수(필수)와 IMAP 2개 변수(선택)를 직접 지정받습니다.

# 발송 (필수)
SMTP_HOST=smtp.example.com
SMTP_PORT=465
SMTP_USER=you@example.com
SMTP_PASSWORD=your-password

# 수신 (선택 — IMAP 설정 시)
IMAP_HOST=imap.example.com
IMAP_PORT=993

주의할 점:

• SSL 포트 465 전용 — 현재 email 스킬은 STARTTLS(587)를 지원하지 않습니다. 서버가 465를 지원해야 합니다.
• IMAP은 선택 — 발송만 필요하다면 SMTP_*만 설정해도 됩니다.
• 서버 주소/포트 문의는 해당 메일 서비스 제공자의 문서를 참조하세요.

환경변수 설정

앱 비밀번호를 발급받았다면, email 스킬이 참조할 수 있도록 환경변수를 설정합니다. 사용 환경에 맞는 방법을 선택하세요.

# 네이버
NAVER_EMAIL=your-id@naver.com
NAVER_APP_PASSWORD=발급받은-앱-비밀번호

# Google (Gmail)
GOOGLE_EMAIL=your-email@gmail.com
GOOGLE_APP_PASSWORD=발급받은-16자리-비밀번호

# Daum / Kakao
DAUM_EMAIL=your-id@daum.net
DAUM_APP_PASSWORD=발급받은-IMAP-전용-비밀번호

NAVER_EMAIL=your-id@naver.com
NAVER_APP_PASSWORD=발급받은-앱-비밀번호
GOOGLE_EMAIL=your-email@gmail.com
GOOGLE_APP_PASSWORD=발급받은-16자리-비밀번호
DAUM_EMAIL=your-id@daum.net
DAUM_APP_PASSWORD=발급받은-IMAP-전용-비밀번호

# 네이버
NAVER_EMAIL=your-id@naver.com
NAVER_APP_PASSWORD=발급받은-앱-비밀번호

# Google (Gmail)
GOOGLE_EMAIL=your-email@gmail.com
GOOGLE_APP_PASSWORD=발급받은-16자리-비밀번호

# Daum / Kakao
DAUM_EMAIL=your-id@daum.net
DAUM_APP_PASSWORD=발급받은-IMAP-전용-비밀번호

claude config set env.NAVER_EMAIL "your-id@naver.com"
claude config set env.NAVER_APP_PASSWORD "발급받은-앱-비밀번호"
claude config set env.GOOGLE_EMAIL "your-email@gmail.com"
claude config set env.GOOGLE_APP_PASSWORD "발급받은-16자리-비밀번호"
claude config set env.DAUM_EMAIL "your-id@daum.net"
claude config set env.DAUM_APP_PASSWORD "발급받은-IMAP-전용-비밀번호"

멀티 계정 설정

같은 제공자의 여러 계정을 동시에 쓰고 싶다면 환경변수 뒤에 suffix를 붙이세요. 예: 회사 Gmail과 개인 Gmail을 모두 쓰거나, 업무용·개인용 네이버 메일을 구분하는 경우입니다.

Suffix 방식 두 가지

email 스킬은 숫자 suffix와 라벨 suffix를 동일하게 처리합니다. 취향에 맞는 쪽을 고르세요.

방식 1: 숫자 suffix (간단)

NAVER_EMAIL_1=a@naver.com
NAVER_APP_PASSWORD_1=앱-비밀번호-A
NAVER_EMAIL_2=b@naver.com
NAVER_APP_PASSWORD_2=앱-비밀번호-B

CLI에서는 --account 1, --account 2로 선택합니다.

방식 2: 라벨 suffix (가독성)

GOOGLE_EMAIL_WORK=work@company.com
GOOGLE_APP_PASSWORD_WORK=회사-앱-비밀번호
GOOGLE_EMAIL_PERSONAL=me@gmail.com
GOOGLE_APP_PASSWORD_PERSONAL=개인-앱-비밀번호

CLI에서는 --account work, --account personal로 선택합니다.

대소문자는 무시됩니다. GOOGLE_EMAIL_WORK, GOOGLE_EMAIL_Work, --account WORK, --account work는 모두 같은 계정을 가리킵니다.

기본 계정(default)과 함께 쓰기

suffix 없는 환경변수(예: NAVER_EMAIL)가 존재하면 이것이 default 계정이 됩니다. suffix 있는 계정이 추가돼도 --account를 생략하면 default가 자동 선택됩니다.

# default (suffix 없음)
NAVER_EMAIL=main@naver.com
NAVER_APP_PASSWORD=기본-비밀번호

# 추가 계정
NAVER_EMAIL_SIDE=side@naver.com
NAVER_APP_PASSWORD_SIDE=서브-비밀번호

이 설정에서 Claude에게 “네이버 메일 보내줘”라고 하면 main@naver.com으로 발송되고, “네이버 서브 계정으로 보내줘”처럼 명시하면 side@naver.com으로 발송됩니다.

--account 생략 규칙

Custom SMTP도 멀티 계정 지원

회사 메일과 자체 서버를 동시에 쓰는 경우에도 동일한 suffix 규칙이 적용됩니다.

SMTP_HOST_COMPANY=smtp.company.com
SMTP_PORT_COMPANY=465
SMTP_USER_COMPANY=you@company.com
SMTP_PASSWORD_COMPANY=회사-메일-비밀번호
IMAP_HOST_COMPANY=imap.company.com
IMAP_PORT_COMPANY=993

SMTP_HOST_SELF=smtp.myserver.net
SMTP_PORT_SELF=465
SMTP_USER_SELF=me@myserver.net
SMTP_PASSWORD_SELF=자체-서버-비밀번호

설정 확인

계정 정보까지 입력했다면, 연결이 제대로 되는지 확인해봅시다.

Claude에게 다음과 같이 요청하면 됩니다:

메일 연결 테스트해줘

모든 설정이 올바르다면 제공자별로 감지된 계정 목록과 ready 상태가 표시됩니다.

멀티 계정을 설정한 경우 다음처럼 계정별로도 확인할 수 있습니다:

google 메일 work 계정 연결 테스트해줘
naver 메일 1번 계정으로 보낸편지함 확인해줘

문제 해결

정리

email 스킬 사용을 위한 설정은 크게 세 단계입니다:

1. 2단계 인증 켜기 — 네이버·Google·Daum 공통 필수 (Custom은 서버 정책에 따름)
2. 앱 비밀번호 발급 — 외부 앱 전용 비밀번호 생성 (Daum은 고정 비밀번호 확인)
3. 환경변수 입력 — Cowork 지침, CLAUDE.md, settings.json, 또는 .env 파일에 저장

필요에 따라 멀티 계정 suffix(_1, _WORK 등)를 조합하면 한 환경에서 회사·개인·프로젝트별 여러 계정을 동시에 다룰 수 있습니다.

한번 설정해두면 이후로는 “메일 보내줘”, “회사 메일함 확인해줘”, “네이버 서브 계정으로 보내줘”만으로 이메일을 자유롭게 다룰 수 있습니다.