n8n에서 Gmail SMTP 앱 비밀번호로 이메일 알림 보내기
n8n에서 Gmail SMTP와 앱 비밀번호로 이메일 알림을 보내는 설정값, Send Email 노드 구성, 본문 줄바꿈이 글자로 찍힌 문제와 해결을 실제 시험 결과로 정리했습니다.
n8n에서 이메일 알림을 보내려고 Gmail을 SMTP로 연결했습니다. 글을 새로 게시하면 주소를 이메일로 알려 주는 워크플로우에 쓰고 있고, 실제로 받은편지함에 도착한 것을 확인했습니다. 이 글은 그때 입력한 값과 순서, 처음에 본문의 줄바꿈이 글자 그대로 찍혔던 문제를 정리한 것입니다.
먼저 알아둘 점
- 구글 도움말은 앱 비밀번호가 2단계 인증이 켜진 계정에서만 쓸 수 있다고 안내합니다. 보안 키만 쓰는 2단계 인증, 회사나 학교 계정, 고급 보호 프로그램 계정에서는 메뉴가 보이지 않을 수 있습니다.
- 같은 도움말 모음의 Gmail 안내 페이지는 앱 비밀번호가 "권장되지 않고 대부분의 경우 필요하지 않다"고 하며, 가능하면 "Google로 로그인" 방식을 쓰라고 합니다. 이 글은 n8n의 SMTP 노드에 앱 비밀번호를 쓰는 방식이고, 구글 OAuth 방식은 시험하지 않았습니다.
- 앱 비밀번호는 일반 로그인 비밀번호가 아닙니다. 대화나 글, 워크플로우 파일에 붙여 넣지 말고 n8n 자격 증명 칸에만 넣습니다.
1. 구글 계정에서 앱 비밀번호 만들기
- 구글 계정에 로그인한 상태에서 구글 도움말이 안내하는 앱 비밀번호 관리 페이지(
myaccount.google.com/apppasswords)를 엽니다. - 앱 이름을 구분되는 이름(예, n8n 알림)으로 입력하고 만듭니다.
- 만들어진 비밀번호를 복사합니다. 도움말은 이 코드를 한 번만 보여 주는지 밝히지 않으므로, 바로 n8n에 붙여 넣는 것이 안전합니다.
이 화면의 문구와 버튼 이름은 구글이 바꿀 수 있어서 글에 적지 않았습니다. 메뉴가 보이지 않으면 위의 2단계 인증 조건부터 확인하세요.
2. n8n에서 SMTP 자격 증명 만들기
n8n의 자격 증명 종류는 SMTP입니다. 제가 입력한 값은 다음과 같습니다.
| 칸 | 입력한 값 |
|---|---|
| User | Gmail 주소 전체 |
| Password | 1단계에서 만든 앱 비밀번호 |
| Host | smtp.gmail.com |
| Port | 465 |
| SSL/TLS | 켜짐 |
| Client Host Name | 비워 둠 |
Port와 SSL/TLS는 자격 증명을 새로 만들 때 이미 465와 켜짐으로 들어 있었고 그대로 두었습니다. 이 조합으로 메일이 도착했지만, 구글의 SMTP 안내 문서와 직접 대조하지는 않았습니다. 587 포트와 STARTTLS 조합은 시험하지 않았습니다.
3. Send Email 노드 설정
워크플로우에는 Send Email 노드(이름은 Email New Post)를 두고 위 자격 증명을 연결했습니다.
| 칸 | 값 |
|---|---|
| From Email | 알림을 받을 같은 Gmail 주소 |
| To Email | 같은 Gmail 주소 |
| Subject | 새 글 게시: 글 주소(식으로 삽입) |
| Email Format | Text |
| Text | 여러 줄 본문(주소, 언어, 안내 문구) |
보내는 주소와 받는 주소를 같게 했습니다. 알림을 나 자신에게만 보내는 용도라서 이렇게 했고, 다른 주소로 보내려면 To Email만 바꾸면 됩니다.
겪은 문제. 본문에 \n이 글자 그대로 찍혔습니다
노드를 열어 보니 Text 칸에 줄바꿈 대신 \n\n이라는 글자가 그대로 보였습니다. 워크플로우 JSON을 만들 때 줄바꿈이 줄바꿈이 아니라 백슬래시와 n 두 글자로 들어간 것이 원인이었습니다. 이메일로 보내면 본문에 그 글자가 그대로 나옵니다.
- Text 칸을 클릭해 식 편집기를 엽니다.
- 내용을 모두 지우고(Cmd+A 후 Delete) 여러 줄로 된 본문을 직접 붙여 넣습니다.
- 칸 옆에 fx 표시가 유지되는지 확인합니다.
JSON 파일을 스크립트나 AI로 만드는 경우 줄바꿈이 두 글자로 들어가지 않았는지 가져오기 전에 확인하는 것이 좋습니다. 텔레그램 노드의 본문도 같은 문제를 겪었습니다.
시험 결과
시험 모드로 워크플로우를 수동 실행해서 확인했습니다.
- 메일이 받은편지함에 도착했습니다(스팸함이 아니었습니다).
- 제목에 글 주소가 들어갔습니다.
- 본문의 줄바꿈이 정상이었고, 주소와 Search Console 링크가 눌러지는 링크로 보였습니다.
- 메일 끝에 n8n이 자동으로 붙이는 안내 문구가 있었습니다. 노드 옵션에서 끌 수 있다고 하지만 옵션 이름은 직접 확인하지 않았습니다.
같은 워크플로우가 텔레그램으로도 알림을 보내는 구성은 댓글 답글 워크플로우 글의 텔레그램 설정과 같은 방식입니다.
확인하지 못한 것
- 비밀번호가 틀렸거나 앱 비밀번호가 폐기되었을 때 n8n에 어떤 오류가 나오는지는 시험하지 않았습니다.
- Google Workspace 계정, 하루 발송 한도, 다른 메일 서비스는 시험하지 않았습니다.
- n8n 2.8.3(자체 호스팅) 기준이며, 다른 버전에서는 노드 이름이나 칸 이름이 다를 수 있습니다.
출처 구글 계정 도움말, 앱 비밀번호로 로그인, Gmail 도움말, 다른 메일 클라이언트에서 Gmail 사용
수정: 2026년 10월 10일