The smtplib.server.sendmail function in python raises UnicodeEncodeError: ‘ascii’ codec can’t encode character

smtplib.server‘s sendmail method expects a bytes instance; if it gets a str it tries to encode it to ASCII, resulting in a UnicodeEncodeError if the str contains any non-ASCII characters.

You can workaround this by encoding the message yourself:

>>> msg = 'Hello Wørld'
>>> from_ = '[email protected]'
>>> to_ = '[email protected]'
>>> subject="Hello"

>>> fmt="From: {}\r\nTo: {}\r\nSubject: {}\r\n{}"

>>> server.sendmail(to_, from_, fmt.format(to_, from_, subject, msg).encode('utf-8'))
{}

This will send this message*:

b'From: [email protected]'
b'To: [email protected]'
b'Subject: Hello'
b'Hello W\xc3\xb8rld'

However this workaround will not work if you want to send non-text binary data with your message.

A better solution is to use the EmailMessage class from the email package.

>>> from email.message import EmailMessage
>>> em = EmailMessage()
>>> em.set_content(msg)
>>> em['To'] = to_
>>> em['From'] = from_
>>> em['Subject'] = subject

>>> # NB call the server's *send_message* method
>>> server.send_message(em)
{}

This sends this message; note the extra headers telling the recipient the encoding used:

b'Content-Type: text/plain; charset="utf-8"'
b'Content-Transfer-Encoding: 8bit'
b'MIME-Version: 1.0'
b'To: [email protected]'
b'From: [email protected]'
b'Subject: Hello'
b'X-Peer: ::1'
b''
b'Hello W\xc3\xb8rld'

* Run the command python -m smtpd -n -c DebuggingServer localhost:1025 in a separate terminal to capture the message data.

Leave a Comment