매일 아침, 이메일과의 전쟁
출근하면 가장 먼저 하는 일이 뭔가요? 아마 메일함을 여는 거겠죠. 밤사이 쌓인 수십 통의 메일. 하나하나 열어보면서 "이건 뉴스레터니까 나중에", "이건 팀장님한테 답장해야 하고", "이건 뭐지?" 하면서 분류하는 데만 30분이 훌쩍 지나갑니다.
이 과정을 매일 반복하고 있다면, 오늘 이걸 자동화해봅시다.
오늘 만들 것
Gmail에서 최근 메일을 가져와서 AI가 자동으로 카테고리 분류
중요하지 않은 메일은 자동으로 읽음 표시
업무 중요 메일에 대해 AI가 답장 초안을 만들어줌
AI가 만든 초안을 사람이 확인하고 승인해야 저장됨
한 번 만들면 매일 아침 자동으로 돌아가게 스케줄 등록
코딩 경험이 없어도 됩니다
이 실습에서 여러분이 직접 코드를 작성할 일은 없습니다. Claude Code에게 프롬프트 하나를 입력하면, 나머지는 AI가 전부 처리합니다. 여러분은 결과를 확인하고 y/n으로 승인만 하면 됩니다.
Gmail 자동화 파이프라인 6단계
우리가 만들 자동화 시스템은 아래 6단계로 동작합니다. 복잡해 보이지만 걱정 마세요. Claude Code가 이 전체를 알아서 만들어줍니다. 여기서는 "어떤 흐름으로 돌아가는지"만 이해하면 됩니다.
수집
Gmail API로 받은편지함에서 최근 메일 50개를 가져옵니다. 보낸 사람, 제목, 본문 내용을 모두 읽어옵니다.
Gmail API분류
AI가 각 메일을 분석해서 4개 카테고리로 자동 분류합니다.
읽음 처리
뉴스레터와 알림으로 분류된 메일은 자동으로 읽음 표시합니다. 더 이상 수동으로 하나씩 클릭할 필요가 없어요.
자동 처리 (사람 개입 없음)답장 초안
업무 중요로 분류된 메일마다 AI가 답장 초안을 작성합니다. 메일 내용을 분석해서 적절한 답변을 자동으로 만들어줘요.
AI 초안 생성승인
AI가 만든 초안은 바로 보내지 않습니다. 터미널에 초안 내용이 표시되고, 여러분이 y를 눌러야 Gmail 임시보관함(Draft)에 저장됩니다.
반복 실행
완성된 스크립트를 매일 아침 자동 실행되도록 스케줄에 등록합니다. 한 번 설정하면 매일 출근 전에 메일 정리가 끝나 있어요.
cron / Task Scheduler핵심 포인트
이 6단계를 여러분이 직접 코딩하는 게 아닙니다. Claude Code에게 프롬프트 하나만 주면, 이 전체 파이프라인을 자동으로 만들어줍니다.
사전 준비: Google Gmail API 설정
Claude Code가 Gmail에 접근하려면 "열쇠"가 필요합니다. 이 열쇠를 OAuth 인증 정보(credentials.json)라고 해요. Google Cloud Console에서 만들 수 있습니다.
왜 이게 필요한가요?
여러분의 Gmail 계정에 프로그램이 접근하려면, Google에서 "이 프로그램을 허용합니다"라는 허가증을 발급받아야 합니다. 이건 보안을 위한 Google의 정책이에요. 한 번만 설정하면 계속 사용할 수 있습니다.
설정 순서
Google Cloud Console 접속
브라우저에서 console.cloud.google.com 에 접속합니다. Google 계정으로 로그인하세요.
프로젝트 생성 → Gmail API 활성화
상단에서 "새 프로젝트"를 만듭니다 (이름은 아무거나 OK). 그 다음 좌측 메뉴에서 "API 및 서비스" → "라이브러리"로 가서 "Gmail API"를 검색하고 "사용" 버튼을 클릭합니다.
OAuth 동의 화면 설정
"API 및 서비스" → "OAuth 동의 화면"에서 "외부"를 선택하고, 앱 이름(아무거나)과 이메일을 입력합니다. 나머지는 기본값으로 진행하세요. "테스트 사용자" 단계에서 본인 Gmail 주소를 추가하세요.
OAuth 클라이언트 ID 만들기
"사용자 인증 정보" → "사용자 인증 정보 만들기" → "OAuth 클라이언트 ID"를 선택합니다. 애플리케이션 유형은 "데스크톱 앱"으로 선택하세요.
credentials.json 다운로드
생성이 완료되면 "JSON 다운로드" 버튼이 나타납니다. 다운로드한 파일을 credentials.json으로 이름을 바꿔서 작업 폴더(autowork)에 넣어주세요.
credentials.json 파일 위치가 중요합니다
다운로드한 파일을 반드시 작업 폴더 안에 넣어야 합니다. Claude Code는 현재 작업 폴더의 파일만 볼 수 있기 때문이에요.
~/Desktop/autowork/credentials.jsonGoogle Cloud Console — Gmail API 활성화 화면
스크린샷 준비 중
Google Cloud Console — OAuth 클라이언트 ID 생성 화면
스크린샷 준비 중
이 과정이 복잡하게 느껴지시나요?
Google Cloud Console이 처음이면 당연히 복잡하게 느껴집니다. 걱정하지 마세요. Claude Code에게 도움을 요청할 수 있습니다!
터미널에서 Claude Code를 실행하고 이렇게 물어보세요:
"Gmail API용 OAuth 설정하는 방법을 단계별로 알려줘"
화면을 보면서 하나씩 따라하면 됩니다. 모르는 부분은 계속 물어보세요.
Claude Code에 입력할 프롬프트
credentials.json이 작업 폴더에 준비되었으면, 이제 Claude Code에게 시킬 차례입니다. 터미널에서 Claude Code를 실행하고(claude 입력), 아래 프롬프트를 그대로 입력하세요.
credentials.json으로
Gmail 자동화 해줘.
메일 분류하고, 뉴스레터는
읽음처리, 업무중요는 답장
초안 잡아줘. emails.json 저장.이게 전부입니다.
프롬프트 하나로 Claude가 아래 전체를 알아서 처리합니다.
Claude가 자동으로 하는 것
credentials.json을 읽어서 OAuth 인증 코드를 자동 생성
받은편지함에서 메일을 가져와서 업무중요/뉴스레터/알림/기타로 분류
중요하지 않은 메일은 읽음 표시로 자동 변경
메일 내용을 분석해서 적절한 답변을 AI가 작성
초안을 보여주고, 승인하면 Gmail 임시보관함에 저장
분류 결과와 처리 내역을 JSON 파일로 기록
Claude Code 구독이 필요합니다
Claude Code를 사용하려면 Claude 구독이 필요합니다. API 키 같은 복잡한 설정은 필요 없고, claude.ai에서 구독만 하면 됩니다.
추천 플랜: Claude Max ($110/월) — Claude Code 사용량이 넉넉해서 자동화 프로젝트를 여유 있게 진행할 수 있습니다. Pro 플랜($20/월)으로도 시작할 수 있지만, 실습을 많이 하다 보면 사용량 제한에 걸릴 수 있어요.
실행하면 이렇게 됩니다
프롬프트를 입력하면 Claude Code가 코드를 작성하고 실행합니다. 터미널에 아래와 같은 결과가 나타납니다.
Gmail 자동화 실행 결과 — 터미널 화면
스크린샷 준비 중
1단계: 메일 수집 + 분류 + 자동 읽음 처리
📧 Gmail 자동화 시작...
✅ Gmail API 연결 성공
📨 메일 50개 수집 완료
📊 분류 결과:
업무 중요 : 8건
뉴스레터 : 22건
알림 : 15건
기타 : 5건
👁️ 뉴스레터 22건 읽음 처리 완료
👁️ 알림 15건 읽음 처리 완료2단계: 답장 초안 승인 화면
✏️ 업무 중요 메일 답장 초안 작성 중...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📩 From: 김팀장 <teamlead@company.com>
📋 제목: 3월 프로젝트 일정 확인 부탁
📝 답장 초안:
"김팀장님, 안녕하세요.
3월 프로젝트 일정 확인했습니다.
현재 진행 상황과 함께 금주 금요일까지
업데이트된 일정표 공유드리겠습니다.
감사합니다."
💾 이 초안을 Gmail Draft에 저장할까요? (y/n): y
✅ Draft 저장 완료!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📩 From: 마케팅팀 <marketing@company.com>
📋 제목: 다음 주 미팅 자료 요청
📝 답장 초안:
"안녕하세요, 마케팅팀.
요청하신 미팅 자료 준비하겠습니다.
월요일 오전까지 공유드릴 수 있을까요?
필요한 항목이 더 있으시면 알려주세요."
💾 이 초안을 Gmail Draft에 저장할까요? (y/n): y
✅ Draft 저장 완료!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 최종 결과:
처리된 메일: 50건
읽음 처리: 37건
답장 초안: 8건 (승인 8건)
저장: emails.json ✅사람이 한 것
프롬프트 1개 + y/n 클릭 몇 번
AI가 한 것
나머지 전부
좋은 프롬프트 작성법 3가지 공식
Claude Code에게 일을 시킬 때, 프롬프트를 어떻게 쓰느냐에 따라 결과가 달라집니다. 아래 3가지 공식만 기억하면 됩니다.
공식 1: 파일 이름을 명시하라
| Bad | Good |
|---|---|
| ❌ "이 파일 분석해줘" | ✅ "sales.csv를 읽어서" |
| ❌ "데이터 정리해줘" | ✅ "report.xlsx 열어서" |
어떤 파일인지 정확히 알려줘야 AI가 바로 실행할 수 있습니다.
공식 2: 결과물을 명시하라
| Bad | Good |
|---|---|
| ❌ "정리해줘" | ✅ "요약.xlsx로 저장해줘" |
| ❌ "분석해줘" | ✅ "차트 포함한 보고서.html 만들어줘" |
결과물의 형식과 파일명까지 알려주면, 원하는 형태로 정확히 저장됩니다.
공식 3: 이어서 수정하라
한 번에 완벽할 필요가 없습니다. 결과를 보고 추가 요청하면 됩니다.
프롬프트 공식
[파일/상황] + [원하는 처리] + [결과물 형식/파일명]
예: "sales.csv를 읽어서 부서별 매출 집계하고 요약.xlsx로 저장해줘"
직접 해보기
이제 직접 실행해봅시다. 아래 단계를 따라하세요.
실행 순서
작업 폴더로 이동
credentials.json이 있는 폴더로 이동합니다.
Claude Code 실행
claude프롬프트 입력
credentials.json으로
Gmail 자동화 해줘.
메일 분류하고, 뉴스레터는
읽음처리, 업무중요는 답장
초안 잡아줘. emails.json 저장.실행 과정 지켜보기
Claude가 코드를 작성하고 실행하는 과정을 지켜보세요.
답장 초안 승인
초안이 표시되면 y 또는 n으로 응답하세요.
실행 중 주의사항
- Google 로그인 창이 뜹니다 — 처음 실행 시 브라우저에서 Google 로그인 화면이 열립니다. "허용"을 클릭하세요. "확인되지 않은 앱" 경고가 나오면 "고급" → "계속"을 누르세요.
- y/n 선택은 원하는 대로 — 답장 초안이 마음에 들면 y, 아니면 n을 누르세요. n을 눌러도 아무 문제 없습니다. Draft에 저장하지 않을 뿐이에요.
- 에러가 나도 당황하지 마세요 — Claude Code는 에러가 발생하면 스스로 원인을 분석하고 수정합니다. 가만히 지켜보면 자동으로 해결하는 경우가 대부분입니다.
확인 체크리스트
잘 안 되나요?
가장 흔한 문제는 credentials.json 파일 위치입니다. 작업 폴더에 파일이 있는지 다시 확인해보세요.
그래도 안 되면 Claude Code에게 이렇게 물어보세요: "에러 원인을 찾아서 해결해줘"
매일 아침 자동 실행 설정
자동화 스크립트가 완성되었으면, 매일 아침 자동으로 실행되게 만들 수 있습니다. Claude Code가 만든 Python 스크립트를 스케줄러에 등록하면 됩니다.
Claude Code에게 이렇게 요청하세요:
이 스크립트를 매일 아침 9시에
자동 실행되도록 등록해줘Claude Code가 운영체제에 맞게 자동으로 설정해줍니다. 직접 설정하고 싶다면 아래를 참고하세요.
OS별 스케줄 설정 방법
# Windows Task Scheduler 사용
# 1. 시작 메뉴 → "작업 스케줄러" 검색 → 실행
# 2. "기본 작업 만들기" 클릭
# 3. 이름: "Gmail 자동화"
# 4. 트리거: "매일" → 오전 9:00
# 5. 동작: "프로그램 시작"
# 프로그램: python
# 인수: gmail_auto.py
# 시작 위치: C:\Users\PC\Desktop\autowork
# 6. 마침
# 또는 PowerShell로 한 번에 등록:
$action = New-ScheduledTaskAction `
-Execute "python" `
-Argument "gmail_auto.py" `
-WorkingDirectory "$HOME\Desktop\autowork"
$trigger = New-ScheduledTaskTrigger `
-Daily -At 9am
Register-ScheduledTask `
-TaskName "Gmail자동화" `
-Action $action `
-Trigger $trigger스케줄 등록도 Claude Code에게 맡기세요
위 설정이 복잡하게 느껴진다면, 그냥 Claude Code에게 "매일 아침 9시에 자동 실행되게 해줘"라고 말하면 됩니다. OS를 자동으로 감지해서 알아서 등록해줍니다.
정리
오늘 만든 Gmail 자동화 흐름
사람이 한 것: 프롬프트 1개 + y/n 몇 번
AI가 한 것: 나머지 전부
코드를 직접 짜지 않아도, 매일 30분 걸리던 메일 정리가 자동화됩니다.
다음 실습으로 넘어가세요
Gmail 자동화를 완료했다면, 다음 챕터에서는 엑셀 자동화를 배웁니다. 매주 반복하는 엑셀 집계 작업을 프롬프트 하나로 해결하는 방법을 알아보겠습니다.