ESP8266 GMail Sender





Introduction: ESP8266 GMail Sender

Hello and welcome to my first Instructable.

I will show you how to send emails from any ESP8266 wifi module using Gmail server.

This instructable relies on Arduino core for ESP8266 WiFi chip,

which makes a self-contained microcontroller from it (no need of AT commands and master devices).

You can connect sensors and get notified by email about changes.

Before we begin

Required hardware:

  1. Any ESP8266 (I'm using ESP8266-07 ebay link).
  2. In my case USB UART Board(I'm using FT232RL FTDI Serials Adapter Module ebay). Not needed if your board has usb port.
  3. Some jumper cables.
  4. WIFI router of course.

List may be incomplete.

Required software:

  1. Arduino Software
  2. Arduino core for ESP8266 WiFi chip
  3. Sketch with project and test code (

Step 1: Gmail Account Setup

We are going to use SMTP to send messages.

Using SMTP Authentication we provide only email and password,

by default Google uses more complex verification methods so we need to change settings.

Go to your Google account settings and enable "Allow less secure apps" at the bottom of the page.

This mean apps only need your email and password when login to your gmail account.

If you concerned about security, just use different account.

Step 2: Edit Sketch

I wrote a little sketch which send one test message to check if all works as should.

When all software downloaded and installed:

  • Unzip
  • Find and open ESP8266_Gmail_Sender.ino
  • Set your wifi access point name (SSID) and password. Should be like this:
const char* ssid = "MyWiFi";
const char* password = "12345678";
  • In setup() function find
if(gsender->Subject(subject)->Send("", "Setup test"))

First parameter of Send() function is recipient email, second message text.

Change recipient from to your email which will receive a message.

I'm receiving many emails every day because some of You guys not attentive, PLEASE DON'T FORGET TO CHANGE RECIPIENT EMAIL!

Subject function is optional! Subject sets once and stored until you change it.

You can send mails without subject or if it already set

gsender->Send(to, message);
  • Now open Gsender.h tab
  • We need Base64 encoded email address and password of gmail account which will be used to send emails.

You can use for encoding, result must be something like:

const char* EMAILBASE64_LOGIN = "Y29zbWkxMTExMUBnbWFpbC5jb20=";
  • Now set FROM field.
const char* FROM = "";

That`s all for this part.

Step 3: Code Uploading and Testing

Save changes. Don`t forget to set your board in Tool menu.

Upload sketch to your ESP8266 board.

Open Serial monitor, board will print log messages.

That`s all I hope you will receive "Message send.". Thanks...

12 People Made This Project!


  • Water Contest

    Water Contest
  • Oil Contest

    Oil Contest
  • Clocks Contest

    Clocks Contest

132 Discussions

How would I send to multiple recipients so the recipiants could view who else was emailed in the "To:" header of the received email?

I have done everything described on your tutorial, and I always have the error about missing the wifi settings. Actually my question is where I have to get ESP8266WiFi.h cause I think that I don't have it.

I'm a beginner and I have to make the progect with trash box that send email when it's full. i'm using a different model of esp 8266. It's simplier than yours

Heeeeeelp me please!!!!

1 reply

I know its been 11 months since you asked so I hope you got it to work, but I will address it anyway.
The ESP8266WiFi is part of your ESP8266 core that you should have installed.
the amazon link shows an esp8266-01, whereas this project is done with an ESP8266-12, that breaks out more pins, but in essence there is not so much difference

Hi boris , this is my problem's text: #include "Gsender.h" .

I can't fix the problem

1 more answer

Your question is easier to answer if you say what your problem with #include "Gsender.h" is.
Anyway, I am going to throw in a few possibilities
1: you have not installed the Gsender.h lib ->install it
2: you have put it in the wrong place. with #include "Gsender.h", the compiler expects to find it in the sketch directory. If you are using the greater than and smaller than signs it expects to find it in the libraries folder

Usted podría enviarme el código completo utilizado para el Wemos D1. Soy novato en este ambiente. Gracias por su atención. Luiz

I have succeeded according to your guidance.

Now I want to add the warning, for example when the signal level 1 from the sensor to send gmail then how?

thank you

Estupendo trabajo. Lo conocí mediante otro usuario en Youtube, indagué un poco y di con su creador. Enhorabuena. Me ha venido de maravilla para mi proyecto de alarma. Gracias.


Question 4 months ago

I have arduino mega2560 and ESP8266 with ESP-01.

When attaching ESP-01 on arduino

RX ------ RX

TX ------- TX

VCC ----- 5V

GND ----- GND

after uploading will maked a error:

warning: espcomm_sync failed

error: espcomm_open failed

error: espcomm_upload_mem failed

error: espcomm_upload_mem failed

What should I do?

Thank you.

1 more answer

connect GPI0 to ground and also connect Reset pin of Arduino to ground. Hope this helps.

I had done all the instructions given above. Connection established getting IP address. But finally getting

220 ESMTP a9sml4857646pfe.147 - gsmtp

502 5.5.1 Unrecognized command. a9sml4857646pfe.147 - gsmtp

Error Sending message : identification error.

Please Help Me

Hi, great code but i have a little problem

I´m using a wemos lolin esp32 oled but the serial monitor give this error: Error sending message: Sending message error

Any idea about that error?


P.D. I didn´have the ESP8266WiFi.h library so i used WiFi.h

6 replies

Hello. Gsender rely on libraries from Arduino Esp8266 core, it won't work with WiFi.h

Borya, I would like to follow up with my experience with your code and the ESP32 in particular the M5Stack. Turning on debugging everything seems to work until we get to the part

354 Go ahead h82sm13795626itb.38 - gsmtp

Subject: Message from ESP8266!
Mime-Version: 1.0
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: 7bit

this forum doesn't like what I pasted. Anyway it sends exactly the same identical text. Could it be that the ESP32 does not code UTF-8 in 7 bits?


Hello RodrigoE32,

Did you had any look on improving the code for the ESP32?


Has anyone tried using this Gmail email sender with EthernetClient? I have tried using it but it does not get out of the while loop in !AwaitSMTPResponse(client, "235"). For some reason client.available() is never true and this gets into an infinite while loop. Any help would be greatly appreciated.