![\"MicroPython](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/ESP32-ESP8266-Send-Emails-Micropython.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nIf you prefer to program your boards using Arduino IDE, you can check the following tutorials instead:<\/p>\n\n\n\n
- ESP32 Send Emails using an SMTP Server: HTML, Text, and Attachments (Arduino IDE)<\/a><\/li>
- ESP8266 NodeMCU Send Emails using an SMTP Server: HTML, Text, and Attachments (Arduino)<\/a><\/li><\/ul>\n\n\n\n
Prerequisites<\/h2>\n\n\n\n
New to MicroPython? You can get started here: Getting Started with MicroPython on ESP32 and ESP8266<\/a>.<\/p>\n\n\n\n
To follow this tutorial you need MicroPython firmware installed in your ESP32 or ESP8266 boards. You also need an IDE to write and upload the code to your board. We suggest using Thonny IDE or uPyCraft IDE:<\/p>\n\n\n\n
- Thonny IDE:
- Installing and getting started with Thonny IDE<\/a><\/li>
- Flashing MicroPython Firmware with esptool.py<\/a><\/li><\/ul><\/li>
- uPyCraft IDE:
- Getting Started with uPyCraft IDE<\/a><\/li>
- Install uPyCraft IDE (Windows<\/a>, Mac OS X<\/a>, Linux<\/a>)<\/li>
- Flash\/Upload MicroPython Firmware to ESP32 and ESP8266<\/a><\/li><\/ul><\/li><\/ul>\n\n\n\n
Or, if you’re familiar with VS Code, you may want to use the PyMakr extension:<\/p>\n\n\n\n
- MicroPython: Program ESP32\/ESP8266 using VS Code and Pymakr<\/a><\/li><\/ul>\n\n\n\n
For a comparison between different MicroPython IDEs, read: MicroPython IDEs for ESP32 and ESP8266<\/a>.<\/p>\n\n\n\n
Learn more about MicroPython: MicroPython Programming with ESP32 and ESP8266 eBook<\/a>.<\/p>\n\n\n\n
Introducing SMTP Servers<\/h2>\n\n\n\n
SMTP <\/strong>means Simple Mail Transfer Protocol<\/em> and it is an internet standard for email transmission. To send emails using an ESP32 or ESP8266 board, you need to connect them to an SMTP Server.<\/p>\n\n\n\n
uMail Module<\/h3>\n\n\n\n
To easily send emails with MicroPython, we’ll use a module called uMail<\/a>. This module is not part of the standard collection of MicroPython libraries, so we’ll need to upload it separately to our board\u2014we’ll provide instructions for this later in the tutorial.<\/p>\n\n\n\n
SMTP Server Settings<\/h3>\n\n\n\n
To send emails with the ESP32 or ESP8266 boards, you need a sender email and you’ll need to know your email SMTP server settings. Below you’ll find the settings for the most popular email providers.<\/p>\n\n\n\n
Gmail SMTP Server Settings<\/h4>\n\n\n\n
If you’re using a Gmail account, these are the SMTP Server details:<\/p>\n\n\n\n
- SMTP Server: smtp.gmail.com<\/strong><\/li>
- SMTP username: Complete Gmail address<\/li>
- SMTP password: Your Gmail password<\/li>
- SMTP port (TLS): 587<\/strong><\/li>
- SMTP port (SSL): 465<\/strong><\/li>
- SMTP TLS\/SSL required: yes<\/strong><\/li><\/ul>\n\n\n\n
Outlook SMTP Server Settings<\/h4>\n\n\n\n
For Outlook accounts, these are the SMTP Server settings:<\/p>\n\n\n\n
- SMTP Server: smtp.office365.com<\/strong><\/li>
- SMTP Username: Complete Outlook email address<\/li>
- SMTP Password: Your Outlook password<\/li>
- SMTP Port: 587<\/strong><\/li>
- SMTP TLS\/SSL Required: Yes<\/strong><\/li><\/ul>\n\n\n\n
Live or Hotmail SMTP Server Settings<\/h4>\n\n\n\n
For Live or Hotmail accounts, these are the SMTP Server settings:<\/p>\n\n\n\n
- SMTP Server: smtp.live.com<\/strong><\/li>
- SMTP Username: Complete Live\/Hotmail email address<\/li>
- SMTP Password: Your Windows Live Hotmail password<\/li>
- SMTP Port: 587<\/strong><\/li>
- SMTP TLS\/SSL Required: Yes<\/strong><\/li><\/ul>\n\n\n\n
If you’re using another email provider, you need to search for its SMTP Server settings\u2014you’ll easily find them with a quick google search.<\/p>\n\n\n\n
Sender Email (New Account)<\/h2>\n\n\n\n
We recommend creating a new email account to send the emails to your main personal email address. Do not use your main personal email to send emails via ESP32 or ESP8266<\/strong>. If something goes wrong in your code or if by mistake you make too many requests, you can be banned or have your account temporarily disabled.<\/p>\n\n\n\n
We’ll use a newly created Gmail.com account to send the emails, but you can use any other email provider. The receiver email can be your personal email without any problem.<\/p>\n\n\n\n
Create a Sender Email Account<\/h3>\n\n\n\n
Create a new email account for sending emails with the ESP32\/ESP8266. If you want to use a Gmail account, go to this link<\/a> to create a new one.<\/p>\n\n\n
\n![\"Gmail](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/02\/GMAIL-create-a-new-account.png?resize=940%2C602&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nCreate an App Password<\/h3>\n\n\n\n
You need to create an app password so that new devices can send emails using your Gmail account. An App Password is a 16-digit passcode that gives a less secure app or device permission to access your Google Account. Learn more about sign-in with app passwords here<\/a>.<\/p>\n\n\n\n
An app password can only be used with accounts that have 2-step verification turned on<\/a><\/strong>. <\/p>\n\n\n\n
- Open your\u00a0Google Account<\/a>.<\/li>
- In the navigation panel, select\u00a0Security<\/strong>.<\/li>
- Under \u201cSigning in to Google,\u201d select\u00a02-Step Verification<\/strong>\u00a0> Get started<\/strong>.<\/li>
- Follow the on-screen steps.<\/li><\/ol>\n\n\n\n
After enabling 2-step verification, you can create an app password.<\/p>\n\n\n\n
- Open your\u00a0Google Account<\/a>.<\/li>
- In the navigation panel, select\u00a0Security<\/strong>.<\/li>
- Under \u201cSigning in to Google,\u201d select App Passwords<\/strong>.<\/li><\/ol>\n\n\n
\n![\"Create](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2021\/06\/create-app-password-gmail.png?resize=724%2C323&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n- In the Select app field, choose mail<\/strong>. For the device, select Other<\/strong> and give it a name, for example ESP32.<\/em> Then, click on Generate<\/strong>. It will pop-up a window with a password that you’ll use with the ESP32 or ESP8266 to send emails. Save that password (even though it says you won’t need to remember it) because you’ll need it later.<\/li><\/ol>\n\n\n\n
![\"Generated](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2021\/06\/generated-app-password-gmail.png?resize=654%2C474&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nNow, you should have an app password that you’ll use on the ESP32\/ESP8266 micropython script to send the emails.<\/p>\n\n\n
\n![\"Gmail](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2021\/06\/Gmail-app-password-created-for-esp32-send-emails.png?resize=713%2C515&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nIf you’re using another email provider, check how to create an app password. You should be able to find the instructions with a quick google search “your_email_provider<\/strong> + create app password”.<\/p>\n\n\n\n
Uploading the uMail Module<\/h2>\n\n\n\n
To send the emails, we’ll use the uMail module. You can check its Github page and several examples here<\/a>. This library isn\u2019t part of the standard MicroPython library by default. So, you need to upload the following file to your ESP32\/ESP8266 board (save it with the name umail.py<\/span>) before using the library.<\/p>\n\n\n
# Complete project details: https:\/\/RandomNerdTutorials.com\/micropython-send-emails-esp32-esp826\/\n# uMail (MicroMail) for MicroPython\n# Copyright (c) 2018 Shawwwn <shawwwn1@gmai.com> https:\/\/github.com\/shawwwn\/uMail\/blob\/master\/umail.py\n# License: MIT\nimport usocket\n\nDEFAULT_TIMEOUT = 10 # sec\nLOCAL_DOMAIN = '127.0.0.1'\nCMD_EHLO = 'EHLO'\nCMD_STARTTLS = 'STARTTLS'\nCMD_AUTH = 'AUTH'\nCMD_MAIL = 'MAIL'\nAUTH_PLAIN = 'PLAIN'\nAUTH_LOGIN = 'LOGIN'\n\nclass SMTP:\n def cmd(self, cmd_str):\n sock = self._sock;\n sock.write('%s\\r\\n' % cmd_str)\n resp = []\n next = True\n while next:\n code = sock.read(3)\n next = sock.read(1) == b'-'\n resp.append(sock.readline().strip().decode())\n return int(code), resp\n\n def __init__(self, host, port, ssl=False, username=None, password=None):\n import ssl\n self.username = username\n addr = usocket.getaddrinfo(host, port)[0][-1]\n sock = usocket.socket(usocket.AF_INET, usocket.SOCK_STREAM)\n sock.settimeout(DEFAULT_TIMEOUT)\n sock.connect(addr)\n if ssl:\n sock = ssl.wrap_socket(sock)\n code = int(sock.read(3))\n sock.readline()\n assert code==220, 'cant connect to server %d, %s' % (code, resp)\n self._sock = sock\n\n code, resp = self.cmd(CMD_EHLO + ' ' + LOCAL_DOMAIN)\n assert code==250, '%d' % code\n if not ssl and CMD_STARTTLS in resp:\n code, resp = self.cmd(CMD_STARTTLS)\n assert code==220, 'start tls failed %d, %s' % (code, resp)\n self._sock = ssl.wrap_socket(sock)\n\n if username and password:\n self.login(username, password)\n\n def login(self, username, password):\n self.username = username\n code, resp = self.cmd(CMD_EHLO + ' ' + LOCAL_DOMAIN)\n assert code==250, '%d, %s' % (code, resp)\n\n auths = None\n for feature in resp:\n if feature[:4].upper() == CMD_AUTH:\n auths = feature[4:].strip('=').upper().split()\n assert auths!=None, "no auth method"\n\n from ubinascii import b2a_base64 as b64\n if AUTH_PLAIN in auths:\n cren = b64("\\0%s\\0%s" % (username, password))[:-1].decode()\n code, resp = self.cmd('%s %s %s' % (CMD_AUTH, AUTH_PLAIN, cren))\n elif AUTH_LOGIN in auths:\n code, resp = self.cmd("%s %s %s" % (CMD_AUTH, AUTH_LOGIN, b64(username)[:-1].decode()))\n assert code==334, 'wrong username %d, %s' % (code, resp)\n code, resp = self.cmd(b64(password)[:-1].decode())\n else:\n raise Exception("auth(%s) not supported " % ', '.join(auths))\n\n assert code==235 or code==503, 'auth error %d, %s' % (code, resp)\n return code, resp\n\n def to(self, addrs, mail_from=None):\n mail_from = self.username if mail_from==None else mail_from\n code, resp = self.cmd(CMD_EHLO + ' ' + LOCAL_DOMAIN)\n assert code==250, '%d' % code\n code, resp = self.cmd('MAIL FROM: <%s>' % mail_from)\n assert code==250, 'sender refused %d, %s' % (code, resp)\n\n if isinstance(addrs, str):\n addrs = [addrs]\n count = 0\n for addr in addrs:\n code, resp = self.cmd('RCPT TO: <%s>' % addr)\n if code!=250 and code!=251:\n print('%s refused, %s' % (addr, resp))\n count += 1\n assert count!=len(addrs), 'recipient refused, %d, %s' % (code, resp)\n\n code, resp = self.cmd('DATA')\n assert code==354, 'data refused, %d, %s' % (code, resp)\n return code, resp\n\n def write(self, content):\n self._sock.write(content)\n\n def send(self, content=''):\n if content:\n self.write(content)\n self._sock.write('\\r\\n.\\r\\n') # the five letter sequence marked for ending\n line = self._sock.readline()\n return (int(line[:3]), line[4:].strip().decode())\n\n def quit(self):\n self.cmd("QUIT")\n self._sock.close()\n<\/code><\/pre>\n\tView raw code<\/a><\/p>\n\n\n\n
Regardless of the IDE you’re using, these are the general instructions to upload the uMail library to your board:<\/p>\n\n\n\n
- First, make sure your board is running MicroPython firmware\u2014check the Prerequisites section<\/a>.<\/li>
- Create a new file in your IDE with the name umail.py<\/span> and paste the previous code there. Save that file.<\/li>
- Establish a serial communication with your board using your IDE.<\/li>
- Upload the umail.py<\/span> file to your board.<\/li>
- At this point, the library should have been successfully uploaded to your board. Now, you can use the library functionalities in your code by importing the library: import umail<\/span>.<\/li><\/ol>\n\n\n\n
Sending Emails with the ESP32\/ESP8266 (MicroPython) – Code<\/h2>\n\n\n\n
At this point, you should have uploaded the umail.py<\/span> file to your board to be able to send emails using the umail<\/span> module. <\/p>\n\n\n\n
The following script sends a simple email when the ESP32\/ESP8266 board first boots\/resets.<\/p>\n\n\n
# Complete project details: https:\/\/RandomNerdTutorials.com\/micropython-send-emails-esp32-esp826\/\n# Micropython lib to send emails: https:\/\/github.com\/shawwwn\/uMail\nimport umail\nimport network\n\n# Your network credentials\nssid = 'REPLACE_WITH_YOUR_SSID'\npassword = 'REPLACE_WITH_YOUR_PASSWORD'\n\n# Email details\nsender_email = 'REPLACE_WITH_THE_SENDER_EMAIL'\nsender_name = 'ESP32' #sender name\nsender_app_password = 'REPLACE_WITH_THE_SENDER_EMAIL_APP_PASSWORD'\nrecipient_email ='REPLACE_WITH_THE_RECIPIENT_EMAIL'\nemail_subject ='Test Email'\n\ndef connect_wifi(ssid, password):\n #Connect to your network\n station = network.WLAN(network.STA_IF)\n station.active(True)\n station.connect(ssid, password)\n while station.isconnected() == False:\n pass\n print('Connection successful')\n print(station.ifconfig())\n \n# Connect to your network\nconnect_wifi(ssid, password)\n\n# Send the email\nsmtp = umail.SMTP('smtp.gmail.com', 465, ssl=True) # Gmail's SSL port\nsmtp.login(sender_email, sender_app_password)\nsmtp.to(recipient_email)\nsmtp.write("From:" + sender_name + "<"+ sender_email+">\\n")\nsmtp.write("Subject:" + email_subject + "\\n")\nsmtp.write("Hello from ESP32")\nsmtp.send()\nsmtp.quit()\n<\/code><\/pre>\n\tView raw code<\/a><\/p>\n\n\n\n
You need to insert your details on the code before uploading the code to the board: SSID and password, sender email, sender name, and corresponding app password, recipient’s email, and email subject.<\/p>\n\n\n\n
After inserting all your details you can upload the code to your board. The file with the code needs to be named main.py<\/span>, otherwise, it will not work.<\/p>\n\n\n\n
How the Code Works<\/h3>\n\n\n\n
First, include the required libraries. The umail<\/span> library, which we loaded previously to the board, so that we can send emails, and the network<\/span> library so that we can set the ESP32\/ESP8266 as a wi-fi station to be able to connect to the internet (local network).<\/p>\n\n\n\n
import umail # Micropython lib to send emails: https:\/\/github.com\/shawwwn\/uMail\nimport network<\/code><\/pre>\n\n\n\nInsert your network credentials, SSID and password, on the following variables so that your board can connect to the internet:<\/p>\n\n\n\n
ssid = 'REPLACE_WITH_YOUR_SSID'\npassword = 'REPLACE_WITH_YOUR_PASSWORD'<\/code><\/pre>\n\n\n\nInsert the email details: sender email, sender name, and corresponding app password. You really need to create an app password\u2014using the regular email password won’t work, see this section<\/a>.<\/p>\n\n\n\n
# Email details\nsender_email = 'REPLACE_WITH_THE_SENDER_EMAIL'\nsender_name = 'ESP32' #sender name\nsender_app_password = 'REPLACE_WITH_THE_SENDER_EMAIL_APP_PASSWORD'<\/code><\/pre>\n\n\n\nInsert the recipient’s email on the recipient_email<\/span> variable:<\/p>\n\n\n\n
recipient_email ='REPLACE_WITH_THE_RECIPIENT_EMAIL'<\/code><\/pre>\n\n\n\nThe email subject is set to Test Email<\/span>, but you can change it on the email_subject<\/span> variable.<\/p>\n\n\n\n
email_subject ='Test Email'<\/code><\/pre>\n\n\n\nWe created a function called connect_wifi()<\/span> that accepts as arguments the SSID and password of the network you want to connect to. You should call this function later to actually connect the ESP board to the internet.<\/p>\n\n\n\n
def connect_wifi(ssid, password):\n #Connect to your network\n station = network.WLAN(network.STA_IF)\n station.active(True)\n station.connect(ssid, password)\n while station.isconnected() == False:\n pass\n print('Connection successful')\n print(station.ifconfig())<\/code><\/pre>\n\n\n\nBefore sending the email, we need to connect the ESP32\/ESP8266 to the internet, so call the connect_wifi()<\/span> function (pass as arguments the ssid and password).<\/p>\n\n\n\n
# Connect to your network\nconnect_wifi(ssid, password)<\/code><\/pre>\n\n\n\nNow, we can finally start preparing and sending the email.<\/p>\n\n\n\n
Start by creating an SMTP client using your email provider SMTP settings called smtp<\/span>. Here we’re using a Gmail account. Change the settings if you’re using a different email provider\u2014set the server, port, and if SSL is required or not.<\/p>\n\n\n\n
smtp = umail.SMTP('smtp.gmail.com', 465, ssl=True) # Gmail's SSL port<\/code><\/pre>\n\n\n\nThen, login into your account using the login()<\/span> method on the smtp<\/span> client\u2014pass as arguments the email and corresponding app password.<\/p>\n\n\n\n
smtp.login(sender_email, sender_app_password)<\/code><\/pre>\n\n\n\nSet the recipient using the to()<\/span> method and pass the recipient’s email as an argument:<\/p>\n\n\n\n
smtp.to(recipient_email)<\/code><\/pre>\n\n\n\nThen, use the write()<\/span> method to write the email. You can use this method as follows to set the sender name.<\/p>\n\n\n\n
smtp.write(\"From:\" + sender_name + \"<\"+ sender_email+\">\\n\")<\/code><\/pre>\n\n\n\nAnd you can use the following line to set the email subject.<\/p>\n\n\n\n
smtp.write(\"Subject:\" + email_subject + \"\\n\")<\/code><\/pre>\n\n\n\nFinally, you can actually write your email content. This is just a test email. We’re setting the message to “Hello from the ESP32\/ESP8266” board. The write()<\/span> method sends the email to the SMTP server.<\/p>\n\n\n\n
smtp.write(\"Hello from the ESP32\/ESP8266\")<\/code><\/pre>\n\n\n\nIf you need to send a long string as the email body, break the email message into smaller chunks and send each chunk using the write()<\/span> method\u2014see the uMail library documentation<\/a>.<\/p>\n\n\n\n
Finally, use the send()<\/span> method to make the SMTP server send the email to the recipient.<\/p>\n\n\n\n
smtp.send()<\/code><\/pre>\n\n\n\nIn the end, close the connection with the server using the quit()<\/span> method.<\/p>\n\n\n\n
smtp.quit()<\/code><\/pre>\n\n\n\nDemonstration<\/h2>\n\n\n\n
After uploading the umail<\/span> module and the main.py<\/span> script to your board, run the code or reset\/restart your board. You should get a similar message in the shell indicating that your board connected successfully to the internet.<\/p>\n\n\n
\n![\"micropython](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/micropython-connection-successful.png?resize=638%2C168&quality=100&strip=all&ssl=1\")
<\/a><\/figure><\/div>\n\n\nAfter a while, you should receive a new email on the recipient’s email account.<\/p>\n\n\n
\n![\"test](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/Email-received-micropython.jpg?resize=905%2C254&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nOpen the email to check its content.<\/p>\n\n\n
\n![\"test](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2023\/01\/Email-received-micropython-2.jpg?resize=597%2C267&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nWrapping Up<\/h2>\n\n\n\n
In this tutorial, you learned how to send emails with the ESP32\/ESP8266 using MicroPython firmware. Sending an email using an SMTP server is very straightforward thanks to the uMail Micropython module<\/a>.<\/p>\n\n\n\n
We’ve shown you a simple example application. Now, the idea is to use this feature in your own projects. This can be useful to send notification alerts, sensor readings, and other applications.<\/p>\n\n\n\n
We hope you find this tutorial useful. If you want to use a different notification method, we have a tutorial showing how to send messages to WhatsApp using MicroPython (ESP32 and ESP8266):<\/p>\n\n\n\n
- MicroPython: Send Messages to WhatsApp with the ESP32\/ESP826<\/a><\/li><\/ul>\n\n\n\n
You can check all our MicroPython projects here<\/a>.<\/p>\n\n\n\n
If you want to learn more about programming the ESP32 and ESP8266 boards with MicroPython, check out our eBook: MicroPython Programming with ESP32 and ESP8266<\/strong><\/a>.<\/strong><\/p>\n\n\n\n
Thanks for reading<\/p>\n","protected":false},"excerpt":{"rendered":"
Learn how to program the ESP32 or ESP8266 NodeMCU boards with MicroPython to send emails using an SMTP server. This feature can be useful in your automation and IoT projects … <\/p>\n
- Create a new file in your IDE with the name umail.py<\/span> and paste the previous code there. Save that file.<\/li>
- First, make sure your board is running MicroPython firmware\u2014check the Prerequisites section<\/a>.<\/li>
- In the navigation panel, select\u00a0Security<\/strong>.<\/li>
- In the navigation panel, select\u00a0Security<\/strong>.<\/li>
- SMTP Server: smtp.gmail.com<\/strong><\/li>
- Install uPyCraft IDE (Windows<\/a>, Mac OS X<\/a>, Linux<\/a>)<\/li>
- Flashing MicroPython Firmware with esptool.py<\/a><\/li><\/ul><\/li>
- Installing and getting started with Thonny IDE<\/a><\/li>
- ESP8266 NodeMCU Send Emails using an SMTP Server: HTML, Text, and Attachments (Arduino)<\/a><\/li><\/ul>\n\n\n\n