11. Python으로 이메일 자동화하기 — SMTP, 첨부파일, 대량 발송까지 완벽 정리

처음에는 저 역시 매주 동일한 업무 메일을 수동으로 복사해 발송했습니다. 수신자가 20명을 넘어가면 많은 시간이 소요되었기 때문입니다. 하지만 파이썬 기반의 정기 이메일 자동화 시스템을 구축한 이후, 관련 업무 부담이 획기적으로 감소했습니다.

이 글에서는 VS Code 환경에서 Python을 활용하여 이메일을 자동 발송하는 방법부터 SMTP 설정, 첨부파일 전송, 여러 명에게 대량 발송하는 방법, 그리고 자주 발생하는 오류 해결 방법까지 단계적으로 알아보겠습니다.

이메일 자동화란 무엇인가 — 반복 작업을 대신하는 디지털 비서

이메일 자동화는 사람이 직접 메일을 작성하고 보내는 대신 Python 코드가 자동으로 메일을 발송하도록 만드는 기술입니다.

쉽게 말하면 매일 같은 시간에 같은 업무를 처리해주는 비서 한 명을 두는 것과 비슷합니다.

예를 들어 다음과 같은 업무를 자동화할 수 있습니다.

매일 아침 업무 보고 메일 발송
거래처 견적서 자동 전송
회원 가입 환영 메일 발송
시스템 장애 알림 메일 발송
매출 보고서 자동 발송
예약 확인 메일 자동 발송

특히 반복적인 메일 업무가 많은 경우 업무 시간을 크게 줄일 수 있습니다.

왜 VS Code와 Python 이메일 자동화를 사용할까

VS Code와 Python 조합은 이메일 자동화에 매우 적합합니다.

VS Code의 장점

무료로 사용할 수 있습니다.
Python 개발 환경 구축이 쉽습니다.
자동 완성 기능을 제공합니다.
디버깅 기능이 강력합니다.
다양한 확장 프로그램을 지원합니다.

Python의 장점

문법이 쉽습니다.
이메일 관련 라이브러리가 풍부합니다.
데이터베이스, 엑셀, PDF와 쉽게 연동됩니다.
자동화 업무에 최적화되어 있습니다.

Python 이메일 자동화 환경 구축하기

Python 설치 확인

터미널에서 아래 명령어를 입력합니다.

python --version

정상적으로 버전이 출력되면 설치가 완료된 상태입니다.

VS Code Python 확장 설치

다음 확장 프로그램을 설치합니다.

Python
Pylance

설치 후 VS Code를 재시작합니다.

Python으로 이메일 보내기 위한 기본 개념

이메일 자동화에서 가장 중요한 개념은 SMTP입니다.

SMTP는 이메일을 전송하는 우체국과 비슷한 역할을 합니다.

비유하자면 다음과 같습니다.

이메일 내용 → 편지
SMTP 서버 → 우체국
수신자 주소 → 집 주소
Python 코드 → 우체국 직원

Python은 SMTP 서버를 통해 이메일을 전달하게 됩니다.

Gmail SMTP 설정하기

가장 많이 사용하는 Gmail 기준으로 설명하겠습니다.

Gmail 앱 비밀번호 생성

구글 계정에서 2단계 인증을 활성화합니다.

이후 앱 비밀번호를 생성합니다.

생성된 비밀번호는 Python 코드에서 사용하게 됩니다.

⚠️ 일반 로그인 비밀번호를 사용하는 것이 아니라 앱 비밀번호를 사용해야 합니다.

Python으로 이메일 보내기

가장 기본적인 이메일 발송 예제입니다.

import smtplib
from email.mime.text import MIMEText

sender = "your_email@gmail.com"
receiver = "receiver@gmail.com"
password = "앱비밀번호"

message = MIMEText("Python 이메일 자동화 테스트입니다.")
message["Subject"] = "테스트 메일"
message["From"] = sender
message["To"] = receiver

with smtplib.SMTP_SSL("smtp.gmail.com", 465) as server:
    server.login(sender, password)
    server.send_message(message)

print("메일 발송 완료")

코드를 실행하면 지정한 수신자에게 메일이 전송됩니다.

첨부파일이 포함된 이메일 보내기

실무에서는 PDF 보고서나 엑셀 파일을 첨부하는 경우가 많습니다.

from email.mime.multipart import MIMEMultipart
from email.mime.base import MIMEBase
from email import encoders

msg = MIMEMultipart()

msg["From"] = sender
msg["To"] = receiver
msg["Subject"] = "보고서 자동 발송"

with open("report.pdf", "rb") as file:
    part = MIMEBase("application", "octet-stream")
    part.set_payload(file.read())

encoders.encode_base64(part)

part.add_header(
    "Content-Disposition",
    "attachment",
    filename="report.pdf"
)

msg.attach(part)

이 방식을 사용하면 자동 생성된 PDF 보고서를 이메일로 전송할 수 있습니다.

여러 명에게 이메일 대량 발송하기

업무상 여러 명에게 같은 메일을 보내야 하는 경우가 많습니다.

receivers = [
    "user1@gmail.com",
    "user2@gmail.com",
    "user3@gmail.com"
]

for receiver in receivers:

    message = MIMEText("정기 업무 보고입니다.")

    message["Subject"] = "업무 보고"
    message["From"] = sender
    message["To"] = receiver

    with smtplib.SMTP_SSL(
        "smtp.gmail.com",
        465
    ) as server:

        server.login(
            sender,
            password
        )

        server.send_message(
            message
        )

print("전체 발송 완료")

실제 환경에서는 엑셀이나 CSV 파일에서 이메일 주소를 불러오는 방식이 자주 사용됩니다.

pandas와 연동한 이메일 자동화

Python의 강력한 장점은 데이터 처리와 쉽게 결합된다는 점입니다.

예를 들어 고객 목록 CSV 파일이 있다고 가정해 보겠습니다.

import pandas as pd

df = pd.read_csv("customers.csv")

for email in df["email"]:
    print(email)

이메일 주소를 읽어와 자동 발송할 수 있습니다.

이를 활용하면

고객 뉴스레터
이벤트 안내
결제 알림
회원 관리

업무를 자동화할 수 있습니다.

실전 예제 — 매일 아침 보고서 자동 발송

실무에서 가장 많이 사용하는 사례 중 하나입니다.

자동화 흐름은 다음과 같습니다.

매출 데이터 수집
Python으로 PDF 생성
이메일 자동 작성
담당자에게 자동 전송

사람이 직접 처리하면 10~20분 걸리는 작업이지만 자동화하면 수 초 만에 완료됩니다.

특히 매일 반복되는 업무일수록 효과가 큽니다.

자주 발생하는 오류와 해결 방법

SMTPAuthenticationError

오류 메시지

SMTPAuthenticationError

원인

로그인 정보가 잘못되었거나 앱 비밀번호를 사용하지 않은 경우입니다.

해결 방법

Gmail 2단계 인증 활성화
앱 비밀번호 사용
이메일 주소 확인

ConnectionRefusedError

오류 메시지

ConnectionRefusedError

원인

SMTP 서버 주소 또는 포트가 잘못된 경우입니다.

해결 방법

smtp.gmail.com
465

설정을 확인합니다.

첨부파일을 찾을 수 없는 경우

오류 메시지

FileNotFoundError

원인

파일 경로가 잘못된 경우입니다.

해결 방법

import os

file_path = os.path.join(
    os.getcwd(),
    "report.pdf"
)

절대 경로를 사용하는 것을 권장합니다.

이메일 자동화가 활용되는 분야

사무직

업무 보고 자동 발송
견적서 전송
거래처 관리

개발자

서버 장애 알림
배포 완료 알림
시스템 모니터링

쇼핑몰 운영자

주문 확인 메일
배송 안내 메일
이벤트 홍보 메일

개인 사용자

공부 알림
일정 알림
개인 보고서 전송

핵심 요약

✅ Python 이메일 자동화 체크리스트

Python 설치 확인
Gmail 앱 비밀번호 생성
SMTP 설정 완료
이메일 발송 코드 작성
첨부파일 기능 추가
CSV 또는 pandas 연동
자동 스케줄링 적용

기억해야 할 핵심

SMTP는 이메일 전송의 핵심입니다.
Gmail은 앱 비밀번호를 사용해야 합니다.
첨부파일 기능을 추가하면 실무 활용도가 크게 높아집니다.
pandas와 결합하면 대량 이메일 발송이 가능합니다.
반복 업무일수록 자동화 효과가 커집니다.

마무리

VS Code와 Python을 활용한 이메일 자동화는 가장 빠르게 업무 효율을 높일 수 있는 자동화 기술 중 하나입니다.

특히 매일 반복되는 보고서 발송이나 알림 업무를 수행하는 경우 큰 효과를 볼 수 있습니다.

처음에는 SMTP 설정이 다소 낯설 수 있지만 한 번 구축해두면 이후에는 코드 한 번 실행하는 것만으로 수십 명, 수백 명에게 이메일을 자동으로 전송할 수 있습니다.

자동화의 시작은 거창한 프로젝트가 아니라 반복되는 작은 업무 하나를 줄이는 것에서 출발합니다.

이 블로그 검색

TipSnack | 생활정보·IT·AI 인사이트