Gmail 자동화, 이제 n8n으로 끝낸다 — OAuth2 설정 완벽 가이드

이 가이드로 배우는 것

Google Cloud Console에서 OAuth2 Client ID / Secret 발급
n8n Gmail 자격증명 등록 및 연동
매일 오전 9시 자동 이메일 워크플로우 완성

왜 OAuth2인가?

n8n에서 Gmail을 쓰려면 Google이 "이 앱 믿을 수 있어?" 확인을 해야 한다. 예전에는 앱 비밀번호(App Password)로 간단히 해결됐지만, Google이 2단계 인증 정책을 강화하면서 OAuth2가 사실상 표준이 됐다.

앱 비밀번호와 OAuth2의 차이를 한마디로 요약하면 이렇다.

앱 비밀번호: Google 계정 전체 권한을 가진 긴 문자열. 유출 시 계정 전체가 위험.
OAuth2: Gmail 읽기/보내기 권한만 명시적으로 허용. 토큰 만료 시 자동 갱신, 언제든 권한 철회 가능.

자동화 파이프라인에서 보안이 중요하다면 OAuth2가 정답이다.

사전 준비

Google 계정, n8n 인스턴스(클라우드 또는 로컬), 그리고 10분의 시간이 전부다. 별도 결제 없이 Google Cloud Console 무료 티어로 진행한다.

전체 흐름 한눈에 보기

1Google Cloud Console 프로젝트 생성
2Gmail API 활성화
3OAuth 동의 화면 설정
4OAuth2 클라이언트 ID 생성 (Client ID + Secret 발급)
5n8n에서 Gmail 자격증명 등록
6Google 계정 연결 및 권한 승인
7워크플로우 구성 및 활성화

🎓 무료 인터랙티브 교안

아래 교안을 열면 각 단계별 스크린샷과 함께 직접 따라할 수 있습니다.
Google Cloud Console 화면 구성이 바뀌어도 헷갈리지 않도록 핵심 포인트를 짚어줍니다.

📋 인터랙티브 교안 열기

자주 묻는 질문

Q. "이 앱을 Google에서 확인하지 않았습니다" 경고가 떠요.

개인 테스트용 앱은 Google 검수를 받지 않아도 된다. 경고 화면에서 고급 → "안전하지 않음 계속하기"를 클릭하면 정상 진행된다. 본인 계정에만 쓰는 자동화라면 검수 없이도 완전히 정상 동작한다.

Q. Client Secret을 팝업 닫고 나서 못 찾겠어요.

Client Secret은 처음 생성 시 한 번만 표시된다. 팝업을 닫았다면 기존 Secret을 새로 발급해야 한다. Google Cloud Console → 해당 클라이언트 → 보안 비밀번호 섹션 → "+ Add secret" 클릭하면 새 Secret이 발급된다. 이전 Secret은 자동 무효화되므로 n8n에서도 업데이트해야 한다.

Q. n8n이 로컬에서만 돼요. 클라우드는?

동일하게 적용된다. n8n Cloud, Railway, Render, 또는 VPS에 배포한 인스턴스 모두 OAuth2 자격증명 설정 방법이 동일하다. 단, Google Cloud Console의 승인된 리디렉션 URI를 클라우드 인스턴스 URL로 변경해야 한다.

주의

OAuth2 토큰은 기본 1시간 유효하다. n8n은 자동으로 토큰을 갱신하지만, 자격증명이 비활성화된 상태에서 워크플로우가 실행되면 실패한다. 정기 실행 자동화라면 자격증명 상태를 주기적으로 확인하는 습관을 들이자.