メール送信（Python を使用）

【概要】

Python で，SMTP サーバーを使用してメールを送信する方法を説明する。Python の標準ライブラリ（smtplib，email.mime.text，email.utils）を使用し，SMTP サーバー経由でメールを送信する。単一宛先への送信，複数宛先への一括送信，CC・BCC を指定した送信を扱う。

【目次】

【関連する外部ページ】

【サイト内の関連情報】

1. 前準備

Python 3.12 のインストール

Pythonのインストールを行い、Pythonのプログラムを実行する環境を整える。扱う環境は、Windows搭載パソコンである。金子研究室では、Python 3.12.10を推奨する。

[Windows での Python 3.12 のインストール手順を見るには、ここをクリック]

Windows での Python 3.12 のインストール

以下のいずれかの方法でPython 3.12をインストールする。Pythonがインストール済みの場合、この手順は不要である。

方法 1：winget によるインストール

【インストールコマンドの実行方法】

管理者権限でコマンドプロンプトを起動する（手順：Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」）。そして、コマンド全体をコマンドプロンプトにコピー＆ペーストする。

--scope machine を指定することで、システム全体（全ユーザー向け）にインストールされる。このオプションの実行には管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動するとPATHが反映される。

REM Python 3.12 をシステム領域にインストール
winget install --id Python.Python.3.12 -e --scope machine --silent --accept-source-agreements --accept-package-agreements --override "/quiet InstallAllUsers=1 PrependPath=1 Include_test=0 Include_pip=1 Include_launcher=1 InstallLauncherAllUsers=1 TargetDir=\"C:\Program Files\Python312\""
if not "%ERRORLEVEL%"=="0" ( color 0c & echo Python 3.12 のインストールに失敗しました & ping 127.0.0.1 -n 6 >nul & color )

REM Python と Scripts を PATH 先頭に追加
powershell -NoProfile -Command "$p='C:\Program Files\Python312'; $s=\"$p\Scripts\"; if(Test-Path $p){$k=[Microsoft.Win32.Registry]::LocalMachine.OpenSubKey('SYSTEM\CurrentControlSet\Control\Session Manager\Environment',$true); $c=$k.GetValue('Path','',[Microsoft.Win32.RegistryValueOptions]::DoNotExpandEnvironmentNames); $t=$k.GetValueKind('Path'); $new=$c; if((';'+$new+';') -notlike \"*;$p;*\"){$new=$p+';'+$new}; if((';'+$new+';') -notlike \"*;$s;*\"){$new=$s+';'+$new}; if($new -ne $c){$k.SetValue('Path',$new,$t)}; $k.Close()}"

REM 現在のセッションにも反映（システムPATHを再取得して連結）
for /f "usebackq tokens=2,*" %A in (`reg query "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v Path`) do set "PATH=%B"

REM pip / wheel の更新
python -m pip install --no-user -U pip wheel
if not "%ERRORLEVEL%"=="0" ( color 0c & echo pip / wheel の更新に失敗しました & ping 127.0.0.1 -n 6 >nul & color )

方法 2：インストーラーによるインストール

  1. Python公式サイト（https://www.python.org/downloads/）にアクセスし、「Download Python 3.x.x」ボタンからWindows用インストーラーをダウンロードする。
  2. ダウンロードしたインストーラーを実行する。
  3. 初期画面の下部に表示される「Add python.exe to PATH」にチェックを入れてから「Customize installation」を選択する。このチェックを入れ忘れると、コマンドプロンプトから python コマンドを実行できない。
  4. 「Install Python 3.xx for all users」にチェックを入れ、「Install」をクリックする。

インストールの確認

コマンドプロンプトで以下を実行する。

python --version

バージョン番号（例：Python 3.12.x）が表示されればインストール成功である。「'python' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していない。

Python の開発環境 Visual Studio Code のインストールと Python 用の設定

Python の開発環境Visual Studio Code（プログラムを編集するソフトウェア。以下、VS Code）を整える。

[Windows での Visual Studio Code のインストールと Python 用の設定手順を見るには、ここをクリック]

Windows での Visual Studio Code のインストールと Python 用の設定手順

1. VS Code と拡張機能のインストール

以下のコマンドにより，既存の VS Code を削除し，全ユーザー共有の設定で再インストールしたうえで，拡張機能（VS Code に機能を追加するソフトウェア）をまとめて導入する．

【インストールコマンドの実行方法】

管理者権限でコマンドプロンプトを起動する（手順：Windows キーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」）。そして，コマンド全体をコマンドプロンプトにコピー＆ペーストする。

インストールコマンド


REM ============================================================
REM Microsoft Visual Studio Code
REM ============================================================
REM Build Tools + Desktop development with C++（VCTools）+ 追加コンポーネント（一括）
REM 未インストール時: winget で新規インストール
REM インストール済み時: setup.exe modify でコンポーネント追加（バージョンは変更しない）
winget list --id Microsoft.VisualStudio.BuildTools 2>nul | findstr /i "BuildTools" >nul 2>&1
if %ERRORLEVEL% EQU 0 (
    for /f "usebackq delims=" %P in (`"C:\Program Files (x86)\Microsoft Visual Studio\Installer\vswhere.exe" -products Microsoft.VisualStudio.Product.BuildTools -property installationPath`) do start /wait "" "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "%P" --add Microsoft.VisualStudio.Workload.VCTools --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Component.VC.CMake.Project --add Microsoft.VisualStudio.Component.VC.Llvm.Clang --add Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset --add Microsoft.VisualStudio.Component.Windows11SDK.26100 --add Microsoft.VisualStudio.Component.VC.v143.x86.x64 --includeRecommended --quiet --norestart --nocache
    if not "%ERRORLEVEL%"=="0" ( color 0c & echo Build Tools のコンポーネント追加に失敗しました & ping 127.0.0.1 -n 6 >nul & color )
) else (
    winget install --scope machine --id Microsoft.VisualStudio.BuildTools -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "--quiet --wait --norestart --nocache --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Component.VC.CMake.Project --add Microsoft.VisualStudio.Component.VC.Llvm.Clang --add Microsoft.VisualStudio.Component.VC.Llvm.ClangToolset --add Microsoft.VisualStudio.Component.Windows11SDK.26100 --add Microsoft.VisualStudio.Component.VC.v143.x86.x64"
    if not "%ERRORLEVEL%"=="0" ( color 0c & echo Build Tools のインストールに失敗しました & ping 127.0.0.1 -n 6 >nul & color )
)

REM 全ユーザー共有の拡張機能フォルダ
if not exist "C:\ProgramData\vscode-extensions" mkdir "C:\ProgramData\vscode-extensions"
icacls "C:\ProgramData\vscode-extensions" /grant "Everyone:(OI)(CI)M" /T

REM スタートメニューのショートカットを --extensions-dir 付きで再作成
if exist "C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio Code" rmdir /s /q "C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio Code"
if exist "C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio Code.lnk" del "C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio Code.lnk"
powershell -NoProfile -Command "$s=New-Object -ComObject WScript.Shell; $lnk=$s.CreateShortcut('C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio Code.lnk'); $lnk.TargetPath='C:\Program Files\Microsoft VS Code\Code.exe'; $lnk.Arguments='--extensions-dir \"C:\ProgramData\vscode-extensions\"'; $lnk.Save()"
REM ショートカットの検証
powershell -NoProfile -Command "$s=New-Object -ComObject WScript.Shell; $lnk=$s.CreateShortcut('C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Visual Studio Code.lnk'); Write-Host 'TargetPath:' $lnk.TargetPath; Write-Host 'Arguments:' $lnk.Arguments"

REM ファイル / フォルダ右クリックの「Code で開く」を登録
reg add "HKLM\SOFTWARE\Classes\*\shell\VSCode\command" /ve /d "\"C:\Program Files\Microsoft VS Code\Code.exe\" --extensions-dir \"C:\ProgramData\vscode-extensions\" \"%1\"" /f
reg add "HKLM\SOFTWARE\Classes\Directory\shell\VSCode\command" /ve /d "\"C:\Program Files\Microsoft VS Code\Code.exe\" --extensions-dir \"C:\ProgramData\vscode-extensions\" \"%1\"" /f
reg add "HKLM\SOFTWARE\Classes\Directory\Background\shell\VSCode\command" /ve /d "\"C:\Program Files\Microsoft VS Code\Code.exe\" --extensions-dir \"C:\ProgramData\vscode-extensions\" \"%V\"" /f

REM --extensions-dir 付きで起動する code.cmd ラッパを作成
REM （%* を echo で書くと対話的 cmd で失われるため、PowerShell で [char]37+'*' を書き出す）
powershell -NoProfile -Command "$pct=[char]37; $q=[char]34; $c='@echo off'+[char]13+[char]10+$q+'C:\Program Files\Microsoft VS Code\bin\code.cmd'+$q+' --extensions-dir '+$q+'C:\ProgramData\vscode-extensions'+$q+' '+$pct+'*'+[char]13+[char]10; [IO.File]::WriteAllText('C:\ProgramData\vscode-extensions\vscode.cmd',$c,[Text.Encoding]::ASCII)"

REM 拡張機能のインストール
set "CODE=C:\Program Files\Microsoft VS Code\bin\code.cmd"
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --uninstall-extension GitHub.copilot
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --uninstall-extension GitHub.copilot-chat
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension ms-python.python
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension ms-python.vscode-pylance
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension ms-python.debugpy
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension MS-CEINTL.vscode-language-pack-ja
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension saoudrizwan.claude-dev
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension rust-lang.rust-analyzer
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension tamasfe.even-better-toml
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension anthropic.claude-code
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --install-extension almenon.arepl
"%CODE%" --extensions-dir "C:\ProgramData\vscode-extensions" --list-extensions --show-versions

REM settings.json を作成（自動更新オフ、Python、Claude Code 設定）
if not exist "%APPDATA%\Code\User" mkdir "%APPDATA%\Code\User"
python -c "import json,os;data={'update.mode':'none','update.enableWindowsBackgroundUpdates':False,'extensions.autoUpdate':False,'python.defaultInterpreterPath':r'C:\Program Files\Python312\python.exe','claudeCode.environmentVariables':[{'name':'ANTHROPIC_API_KEY','value':'not-needed'},{'name':'ANTHROPIC_AUTH_TOKEN','value':'ollama'},{'name':'ANTHROPIC_BASE_URL','value':'http://localhost:11434'},{'name':'ANTHROPIC_MODEL','value':'glm-4.7-flash'},{'name':'CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC','value':'1'}]};p=os.path.join(os.environ['APPDATA'],'Code','User','settings.json');open(p,'w',encoding='utf-8').write(json.dumps(data,indent=4));print('Done:',p)"

REM 自動更新の抑止ポリシー（settings.json に加えて、レジストリ側でも明示的にオフ）
reg add "HKLM\SOFTWARE\Policies\Microsoft\VSCode" /v "UpdateMode" /t REG_SZ /d "none" /f
echo === セットアップ完了 ===

2. Python インタプリタの選択

同一マシンに複数の Python がインストールされている場合，VS Code で使用する Python 本体（インタプリタ：Python プログラムを解釈・実行するソフトウェア）を選択する必要がある．

  1. コマンドパレット（コマンド名で機能を呼び出す VS Code の入力欄）を開く（Ctrl+Shift+P）
  2. Python: Select Interpreter と入力する
  3. 表示される一覧から，使用する Python（例：C:\Program Files\Python312\python.exe）を選択する．

Python プログラム実行手順

[Windows での Python プログラム実行手順を見るには、ここをクリック]

Windows での Python 実行手順（Visual Studio Codeを使用）

プログラムファイルの作成と保存

  1. 左サイドバーの「エクスプローラー」アイコン（Ctrl+Shift+E）をクリックする
  2. 「NO FOLDER OPENED」（作業対象フォルダが未選択の状態）と表示される場合は，「Open Folder」をクリックし，プログラムを保存するフォルダを選択する

    続いて「フォルダを信用するか」を確認する画面（フォルダ内のコードを実行してよいか確認する VS Code の仕組み）が表示されるので，チェックして Yes を選択する

  3. フォルダ名の右側に表示される「新しいファイル」アイコンをクリックする
  4. ファイル名（例：aitask.py．ファイル名は何でも良い）を入力し Enter を押す．拡張子は .py（Python ファイルを示す拡張子）とする
  5. 実行したいコードを選択し，Ctrl+C でコピーする．VS Code のエディタ領域に Ctrl+V で貼り付ける
  6. Ctrl+S で保存する

プログラムの実行

  1. エディタ右上の三角形「▷」アイコン（Run Python File：現在開いている Python ファイルを実行するボタン）をクリックする．または，エディタ上で右クリックし「ターミナルで Python ファイルを実行」を選択する
  2. VS Code 下部のターミナル（コマンドの入出力を表示する画面）に，実行結果（print 関数の出力等）が表示される
  3. tkinter（Python 標準の GUI ライブラリ）のファイル選択ダイアログを使うプログラムを実行した場合は，ダイアログが開くので対象画像を選択する
  4. VS Code 下部のターミナルで実行結果を確認する．OpenCV ウィンドウ（OpenCV が画像を表示するために開く専用ウィンドウ）が開いた場合はそちらも確認する．OpenCV ウィンドウは，マウスクリックでウィンドウをアクティブ（操作対象の状態）にしてからキーを押すと終了する

本プログラムが使用する smtplib，email.mime.text，email.utils はすべて Python 標準ライブラリであるため，追加のライブラリインストールは不要である。

2. 実行手順

手順：コードを実行する（メモ帳を用いる場合は a.py のようなファイル名で保存して実行）。

動作確認チェックリスト

確認項目期待される結果
SMTP サーバーへの接続指定した SMTP サーバー（ポート587）に接続し，STARTTLS で暗号化通信が確立される
認証指定したユーザー名・パスワードで SMTP サーバーへのログインが成功する
メール送信（単一宛先）指定した宛先にメールが送信され，件名・本文・送信日時が正しく設定されている
メール送信（複数宛先・CC・BCC）複数宛先への一括送信，CC・BCC を指定した送信がそれぞれ正しく動作する

3. 使い方と実行上の注意

各演習のプログラムは，smtplib を使用して SMTP サーバー経由でメールを送信する。STARTTLS（通信路を暗号化する方式）による暗号化通信を行い，ユーザー名とパスワードで認証したうえで送信する。

使用前に，以下の変数を利用環境に合わせて書き換える。

変数名設定内容
UNAMESMTP 認証用のユーザー名（メールアドレス）
PASSWORDSMTP 認証用のパスワード
SMTP_SERVERSMTP サーバーのホスト名
FROM_ADDR送信元メールアドレス
TO_ADDR / TO_ADDRS宛先メールアドレス（単一は文字列，複数はリスト）
CC_ADDRSCC 宛先メールアドレスのリスト
BCC_ADDRSBCC 宛先メールアドレスのリスト
SUBJECTメールの件名
BODYメールの本文

3種類の送信方法を扱う。

単一宛先への送信：mysendmail 関数を使用する。MIMEText でメッセージを構築し，Subject，From，To，Date の各ヘッダを設定して送信する。

複数宛先への一括送信：mysendmail_multiple 関数を使用する。宛先をリストで指定することで，同一内容のメールを複数の宛先へ一括送信できる。sendmail メソッドの第2引数にリストを渡すと，リスト内の全アドレスに送信される。

CC・BCC を指定した送信：mysendmail_cc_bcc 関数を使用する。CC（Carbon Copy，カーボンコピー）はヘッダに宛先として表示される。BCC（Blind Carbon Copy，ブラインドカーボンコピー）はヘッダに記載されないため，他の受信者からは見えない。sendmail メソッドには，To・CC・BCC を含む全受信者のリストを渡す（BCC は受信者リストには含めるが，ヘッダには書かない）。

4. 演習1：単一宛先への送信

テーマ名：単一の宛先へメールを送信する。

手順：次のコードのうち UNAME，PASSWORD，SMTP_SERVER，FROM_ADDR，TO_ADDR を利用環境に合わせて書き換え，実行する（メモ帳を用いる場合は a.py のようなファイル名で保存して実行）。実行後，宛先に届いたメールを開く。

ヒント：送信日時のヘッダは formatdate で設定している。届いたメールの件名・本文・送信日時を確認する。

考察ポイント：届いたメールで Subject・From・To・Date の各ヘッダがコードで設定した内容と一致しているかを読み取る。

import smtplib
from email.mime.text import MIMEText
from email.utils import formatdate

def mysendmail(uname, password, smtp_server, from_addr, to_addr, subject, body):
    msg = MIMEText(body)
    msg['Subject'] = subject
    msg['From'] = from_addr
    msg['To'] = to_addr
    msg['Date'] = formatdate()
    with smtplib.SMTP(smtp_server, 587) as sv:
        sv.starttls()
        sv.login(uname, password)
        sv.sendmail(from_addr, to_addr, msg.as_string())

UNAME = "user@hoge.com"
PASSWORD = "pass"
SMTP_SERVER = "mailsv.hoge.com"
FROM_ADDR = "user@hoge.com"
TO_ADDR = "other@hoge.com"
SUBJECT = "タイトル"
BODY = "メッセージ本文"

if __name__ == '__main__':
    mysendmail(UNAME, PASSWORD, SMTP_SERVER, FROM_ADDR, TO_ADDR, SUBJECT, BODY)

5. 演習2：複数の宛先への一括送信

テーマ名：同一内容のメールを複数の宛先へ一括送信する。

手順：次のコードのうち UNAME，PASSWORD，SMTP_SERVER，FROM_ADDR，TO_ADDRS を利用環境に合わせて書き換え，実行する（メモ帳を用いる場合は a.py のようなファイル名で保存して実行）。TO_ADDRS には複数の宛先をリストで指定する。実行後，各宛先に届いたメールを開く。

ヒント：宛先のヘッダは ", ".join(to_addrs) で連結し，sendmail の第2引数にはリストをそのまま渡している。

考察ポイント：To ヘッダにすべての宛先が並んで表示されること，リストに指定した全アドレスにメールが届くことを読み取る。

import smtplib
from email.mime.text import MIMEText
from email.utils import formatdate

def mysendmail_multiple(uname, password, smtp_server, from_addr, to_addrs, subject, body):
    msg = MIMEText(body)
    msg['Subject'] = subject
    msg['From'] = from_addr
    msg['To'] = ", ".join(to_addrs)
    msg['Date'] = formatdate()
    with smtplib.SMTP(smtp_server, 587) as sv:
        sv.starttls()
        sv.login(uname, password)
        sv.sendmail(from_addr, to_addrs, msg.as_string())

UNAME = "user@hoge.com"
PASSWORD = "pass"
SMTP_SERVER = "mailsv.hoge.com"
FROM_ADDR = "user@hoge.com"
TO_ADDRS = ["other1@hoge.com", "other2@hoge.com", "other3@hoge.com"]
SUBJECT = "タイトル"
BODY = "メッセージ本文"

if __name__ == '__main__':
    mysendmail_multiple(UNAME, PASSWORD, SMTP_SERVER, FROM_ADDR, TO_ADDRS, SUBJECT, BODY)

6. 演習3：CC・BCC を指定した送信

テーマ名：CC・BCC を指定してメールを送信する。

手順：次のコードのうち UNAME，PASSWORD，SMTP_SERVER，FROM_ADDR，TO_ADDR，CC_ADDRS，BCC_ADDRS を利用環境に合わせて書き換え，実行する（メモ帳を用いる場合は a.py のようなファイル名で保存して実行）。実行後，To・CC・BCC それぞれの宛先に届いたメールを開く。

ヒント：CC はヘッダに設定するが，BCC はヘッダに設定していない。sendmail の第2引数 all_recipients には To・CC・BCC をすべて含めている。

考察ポイント：受信したメールのヘッダで CC は表示され，BCC は表示されないことを読み取る。BCC の宛先にもメールが届くことを確認する。

import smtplib
from email.mime.text import MIMEText
from email.utils import formatdate

def mysendmail_cc_bcc(uname, password, smtp_server, from_addr, to_addr, cc_addrs, bcc_addrs, subject, body):
    msg = MIMEText(body)
    msg['Subject'] = subject
    msg['From'] = from_addr
    msg['To'] = to_addr
    msg['Cc'] = ", ".join(cc_addrs)
    msg['Date'] = formatdate()
    all_recipients = [to_addr] + cc_addrs + bcc_addrs
    with smtplib.SMTP(smtp_server, 587) as sv:
        sv.starttls()
        sv.login(uname, password)
        sv.sendmail(from_addr, all_recipients, msg.as_string())

UNAME = "user@hoge.com"
PASSWORD = "pass"
SMTP_SERVER = "mailsv.hoge.com"
FROM_ADDR = "user@hoge.com"
TO_ADDR = "other@hoge.com"
CC_ADDRS = ["cc1@hoge.com", "cc2@hoge.com"]
BCC_ADDRS = ["bcc1@hoge.com"]
SUBJECT = "タイトル"
BODY = "メッセージ本文"

if __name__ == '__main__':
    mysendmail_cc_bcc(UNAME, PASSWORD, SMTP_SERVER, FROM_ADDR, TO_ADDR, CC_ADDRS, BCC_ADDRS, SUBJECT, BODY)

7. まとめ