IMAP Email Content


The imap_email_content sensor platform will read emails from an IMAP email server and report them as a state change within Home Assistant. This is useful if you have a device that only reports its state via email.

Configuration

To enable this sensor, add the following lines to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: imap_email_content
    server: imap.gmail.com
    port: 993
    username: USERNAME
    password: PASSWORD
    senders:
      - example@gmail.com

Configuration Variables

server

(string)(Required)The IP address or hostname of the IMAP server.

port

(integer)(Optional)The port where the server is accessible.

Default value: 993

name

(string)(Optional)Name of the IMAP sensor.

username

(string)(Required)Username for the IMAP server.

password

(string)(Required)Password for the IMAP server.

senders

(string)(Required)A list of sender email addresses that are allowed to report state via email. Only emails received from these addresses will be processed.

value_template

(template)(Optional)If specified this template will be used to render the state of the sensor. If a template is not supplied the message subject will be used for the sensor value. The following attributes will be supplied to the template.

from

The from address of the email.

body

The body of the email.

subject

The subject of the email.

date

The date and time the email was sent.