{"id":28501156,"url":"https://github.com/microteq/email_notifier","last_synced_at":"2026-04-26T08:39:02.232Z","repository":{"id":297045364,"uuid":"995461456","full_name":"microteq/email_notifier","owner":"microteq","description":"Send email notifications from Home Assistant","archived":false,"fork":false,"pushed_at":"2025-12-26T16:19:12.000Z","size":152,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-28T03:49:19.542Z","etag":null,"topics":["email","email-notification","email-sender","home-assistant","home-automation","integration","notifications"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/microteq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":"FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"microteq","buy_me_a_coffee":"microteq"}},"created_at":"2025-06-03T14:12:32.000Z","updated_at":"2025-12-26T16:16:12.000Z","dependencies_parsed_at":"2025-06-04T01:05:53.757Z","dependency_job_id":"def740bd-7afa-43ee-9ec4-c6419f7c200d","html_url":"https://github.com/microteq/email_notifier","commit_stats":null,"previous_names":["microteq/email_notifier"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/microteq/email_notifier","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microteq%2Femail_notifier","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microteq%2Femail_notifier/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microteq%2Femail_notifier/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microteq%2Femail_notifier/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microteq","download_url":"https://codeload.github.com/microteq/email_notifier/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microteq%2Femail_notifier/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32291336,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T08:29:33.829Z","status":"ssl_error","status_checked_at":"2026-04-26T08:29:18.366Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["email","email-notification","email-sender","home-assistant","home-automation","integration","notifications"],"created_at":"2025-06-08T15:30:36.758Z","updated_at":"2026-04-26T08:39:02.225Z","avatar_url":"https://github.com/microteq.png","language":"Python","funding_links":["https://github.com/sponsors/microteq","https://buymeacoffee.com/microteq","https://www.buymeacoffee.com/microteq"],"categories":[],"sub_categories":[],"readme":"[![License](https://img.shields.io/github/license/microteq/email_notifier.svg)](LICENSE)\n[![HACS Supported](https://img.shields.io/badge/HACS-Supported-green.svg)](https://github.com/custom-components/hacs)\n![GitHub Activity](https://img.shields.io/github/commit-activity/y/microteq/email_notifier.svg?label=commits)\n[![Stable](https://img.shields.io/github/release/microteq/email_notifier.svg)](https://github.com/microteq/email_notifier/releases/latest)\n\u003c!--![Downloads](https://img.shields.io/github/downloads/microteq/email_notifier/total)--\u003e\n\n# Home Assistant Email Notifier\n**Sending email notifications from Home Assistant.**\n\nThe Email Notifier is an integration for Home Assistant allowing you to send email messages, notifications or alerts to any email recipient. The Email Notifier is based on the Home Assistant SMTP integration, but has a user interface for the email server configuration.\n\u003cbr /\u003e\n\u003cbr /\u003e\n\n## Features\n- Send Home Assistant alerts, notifications and messages to email recipient(s).\n- UI-based configuration for easy setup.\n- Backward compatibility with YAML configuration.\n- Supports sending messages to multiple recipients.\n- Send images and attachments.\n- Send plain text or html messages.\n- Options flow to update configurations without reinstallation.\n- Detailed error handling and logging for troubleshooting.\n\u003cbr /\u003e\n\n## Installation\n\n### HACS (recommended)\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=microteq\u0026repository=email_notifier)\n\nThis is the recommended installation method.\n\n- Search for and install the Email Notifier integration from HACS\n- Restart Home Assistant\n\n### Manual\n- Download the latest release.\n- Copy the contents of custom_components into the /config/custom_components directory of your Home Assistant installation.\n- Restart Home Assistant.\n\u003cbr\u003e\n\n## Configuration\n\nIn your Home Assistant go to _Settings_ \u003e _Devices \u0026 services_ and click on _Add integration_. In the search field, search for _email_ and select the integration. This will add an email account entity, you can use to send email notifications from. Fill in the needed information of your mail server. \n\n### Configuration fields\n\n#### SMTP Server\nSMTP server which is used to send the notifications.\n\n#### Port (default: 587)\nThe port that the SMTP server is using.\n\n#### Username\nUsername for the SMTP account.\n\n#### Password\nPassword for the SMTP server that belongs to the given username. \n\n#### Sender Email\nEmail address of the sender.\n\n#### Recipient Email(s)\nDefault email address of the recipient of the notification. This can be a recipient address or a comma delimited list of addresses for multiple recipients.\nThis is where you want to send your email notifications by default (when not specifying recipients in the action). Any email address(es) specified in the action’s recipient field will override this recipient content.\n\n#### Sender name\nSets a custom ‘sender name’ in the emails headers.\n\n#### Encryption (default: starttls)\nSet mode for encryption, starttls, tls or none.\n\n#### Timeout (default: 15)\nThe timeout in seconds that the SMTP server is using.\n\u003cbr\u003e\n\u003cbr\u003e\n\n### Google Mail\nGoogle has some extra layers of protection that need special attention. You must use an **application-specific** password in your notification configuration.\n\nIf any of the following conditions are met you will not be able to create an app password:\n\n- You do not have 2-step verification enabled on your account.\n- You have 2-step verification enabled but have only added a security key as an authentication mechanism.\n- Your Google account is enrolled in Google’s Advanced Protection Program.\n- Your Google account belongs to a Google Workspace that has disabled this feature. Accounts owned by a school, business, or other organization are examples of Google Workspace accounts.\n\u003cbr/\u003e\n\n## Usage\n\nThe Email Notifier creates email accounts from which notifications can be sent. Each account also has a default recipient. In Home Assistant, sending a message is typically used as an action in an automation.\n\n### Using the user interface\n\n#### Method A\nIn your automation, click on _Add action_, then on _Notifications,_ and select the action _Send a notification message_. In the _Message_ field, enter your message, and as _Target_, click on _Choose entity_ and select one (or more) sender email account(s). The recipients(s) will be the default recipients(s) defined in the mail account configuration. Then save your action.\n\n#### Method B\nIn your automation, click on _Add action_, then search for _email_ and select the _Email Notifier: Send Email_ action. Select your sender account and fill out the custom fields you need to send your email, such as recipient(s), subject, plain message, html message, attachments or images.\n\n### Writing YAML\n\n#### Method A\n\n```\nalias: Send Test Message\ndescription: \"\"\ntriggers: []\nconditions: []\nactions:\n  - action: notify.send_message\n    data:\n      message: \"This is a test message from Home Assistant\"\n    target:\n      entity_id: notify.email_notification_sender_1\nmode: single\n```\n\n#### Medod B\n\n```\nalias: Send Test Message\ndescription: \"\"\ntriggers: []\nconditions: []\nactions:\n  - action: email_notifier.send\n    metadata: {}\n    data:\n      account: notify.email_notification_sender_0\n      recipients: \"user@example.com\"\n      title: \"Complete Feature Demo\"\n      message: \"Plain text version of this email\"\n      html: |\n        \u003chtml\u003e\n          \u003cbody\u003e\n            \u003ch1 style=\"color: #0066cc;\"\u003eFeature Demonstration\u003c/h1\u003e\n            \u003cp\u003eThis email showcases all features:\u003c/p\u003e\n            \u003cimg src=\"cid:logo.png\" width=\"200\"/\u003e\n            \u003cul\u003e\n              \u003cli\u003eHTML formatting\u003c/li\u003e\n              \u003cli\u003eInline images\u003c/li\u003e\n              \u003cli\u003eFile attachments\u003c/li\u003e\n              \u003cli\u003eCustom sender info\u003c/li\u003e\n            \u003c/ul\u003e\n          \u003c/body\u003e\n        \u003c/html\u003e\n      images: |\n        https://example.com/logo.png\n      attachments: |\n        /config/www/report.pdf\n        https://example.com/document.pdf\n      from_address: \"noreply@mydomain.com\"\n      sender_name: \"Home Assistant Demo\"\n      reply_to: \"support@mydomain.com\"\n```\n\u003cbr /\u003e\n\n### HTML Email Support\n**Description:** Send rich HTML emails with full styling, images, and formatting.\n\n**Usage Example:**\n```yaml\nservice: email_notifier.send\ndata:\n  account: notify.email_notification_sender_0\n  title: \"Alert Notification\"\n  message: \"Plain text fallback\"\n  html: |\n    \u003chtml\u003e\n      \u003cbody\u003e\n        \u003ch1 style=\"color: blue;\"\u003eAlert\u003c/h1\u003e\n        \u003cp\u003eThis is a \u003cstrong\u003erich HTML\u003c/strong\u003e email with formatting.\u003c/p\u003e\n        \u003cul\u003e\n          \u003cli\u003eFeature 1\u003c/li\u003e\n          \u003cli\u003eFeature 2\u003c/li\u003e\n        \u003c/ul\u003e\n      \u003c/body\u003e\n    \u003c/html\u003e\n  recipients: \"user@example.com\"\n```\n**Features:**\n- Sends as multipart MIME with both plain text and HTML versions\n- Email clients will display HTML version if supported, fall back to plain text otherwise\n- Supports inline images (see Images section below)\n\u003cbr/\u003e\n\n\n### File Attachments (Local \u0026 Remote)\n**Description:** Attach any file type to emails, supporting both local files and remote URLs.\n\n**Supported Sources:**\n- Local files: `/config/www/report.pdf`\n- Remote URLs: `https://example.com/document.pdf`\n\n**Supported File Types:**\n- Documents: PDF, DOCX, TXT, CSV, XLSX\n- Images: JPG, PNG, GIF, BMP\n- Archives: ZIP, RAR, TAR\n- Any other file type\n\n**Usage Example:**\n```yaml\nservice: email_notifier.send\ndata:\n  account: notify.email_notification_sender_0\n  title: \"Monthly Report Package\"\n  message: \"Please find attached the monthly reports.\"\n  attachments: |\n    /config/www/report.pdf\n    https://www.bhphotovideo.com/lit_files/1220335.pdf\n    /config/www/data.csv\n    https://example.com/remote_document.pdf\n  recipients: \"user@example.com\"\n```\n\n**Input Format:**\n- Enter one file path or URL per line in the multiline text box\n- Empty lines are automatically filtered out\n- Whitespace is trimmed from each line\n- Supports http:// and https:// protocols\n\u003cbr/\u003e\n\n### Inline Images (Local \u0026 Remote)\n**Description:** Embed images directly in HTML emails using Content-ID references.\n\n**Usage Example:**\n```yaml\nservice: email_notifier.send\ndata:\n  account: notify.email_notification_sender_0\n  title: \"Camera Alert\"\n  html: |\n    \u003chtml\u003e\n      \u003cbody\u003e\n        \u003ch1\u003eMotion Detected\u003c/h1\u003e\n        \u003cp\u003eCamera snapshot:\u003c/p\u003e\n        \u003cimg src=\"cid:camera.jpg\" width=\"600\"/\u003e\n        \u003cp\u003eLogo:\u003c/p\u003e\n        \u003cimg src=\"cid:logo.png\"/\u003e\n      \u003c/body\u003e\n    \u003c/html\u003e\n  images: |\n    /config/www/camera.jpg\n    https://example.com/logo.png\n  recipients: \"user@example.com\"\n```\n\n**How It Works:**\n- Images are embedded using Content-ID (cid:filename)\n- Reference images in HTML with `\u003cimg src=\"cid:filename.jpg\"/\u003e`\n- Supports both local files and remote URLs\n\u003cbr/\u003e\n\n### Custom \"From\" Address\n**Description:** Override the sender's email address for individual messages.\n\n**Usage Example:**\n```yaml\nservice: email_notifier.send\ndata:\n  account: notify.email_notification_sender_0\n  title: \"Security Alert\"\n  message: \"Motion detected at front door\"\n  from_address: \"security@mydomain.com\"\n  recipients: \"user@example.com\"\n```\n\n**Notes:**\n- Overrides the configured sender address for this message only\n- The SMTP envelope sender remains the configured account (required for authentication)\n- The displayed \"From\" address in the email will be the custom address\n\u003cbr/\u003e\n\n### Custom Display Name (Sender Name)\n**Description:** Set a custom display name for the sender.\n\n**Usage Example:**\n```yaml\nservice: email_notifier.send\ndata:\n  account: notify.email_notification_sender_0\n  title: \"Alert\"\n  message: \"System notification\"\n  sender_name: \"Home Security System\"\n  recipients: \"user@example.com\"\n```\n\n**Combined with Custom From Address:**\n```yaml\nservice: email_notifier.send\ndata:\n  account: notify.email_notification_sender_0\n  title: \"Alert\"\n  message: \"Notification\"\n  from_address: \"alerts@mydomain.com\"\n  sender_name: \"Home Assistant Alerts\"\n  recipients: \"user@example.com\"\n```\n\nThis will display as: **\"Home Assistant Alerts \u003calerts@mydomain.com\u003e\"**\n\u003cbr/\u003e\u003cbr/\u003e\n\n### Custom Reply-To Address\n**Description:** Specify where recipient replies should be directed.\n\n**Usage Example:**\n```yaml\nservice: email_notifier.send\ndata:\n  account: notify.email_notification_sender_0\n  title: \"Survey\"\n  message: \"Please reply with your feedback\"\n  reply_to: \"feedback@mydomain.com\"\n  recipients: \"user@example.com\"\n```\n\n**Use Cases:**\n- Direct replies to a support mailbox\n- Separate sending and receiving addresses\n- No-reply scenarios with monitored reply-to address\n\u003cbr/\u003e\u003cbr/\u003e\u003cbr/\u003e\n\n## License\n\nThis integration is published under the GNU General Public License v3.0.\n\u003cbr /\u003e\n\u003cbr/\u003e\n\n## Attribution\n\nThe Email Notifier is based on the Home Assistant SMTP integration. Thanks to onoffautomations for adding some new features.\n\u003cbr /\u003e\n\u003cbr /\u003e\n\u003cbr /\u003e\n\u003cbr /\u003e\n\u003cbr /\u003e\n\u003cbr /\u003e\n\n## About sponsorship\n\nIf this Home Assistant integration is helpful to you, please consider supporting this project. Sponsorship helps keep the project going, improve features, and fix any issues that arise. Your contribution goes a long way in making the project better for everyone.\n\n\n[![Sponsor me on GitHub](https://img.shields.io/badge/sponsor-me%20on%20GitHub-green)](https://github.com/sponsors/microteq)\n\n\u003ca href=\"https://www.buymeacoffee.com/microteq\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" width=\"140\" height=\"38\" style=\"height: 38px !important;width: 140px !important;\" \u003e\u003c/a\u003e\n\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicroteq%2Femail_notifier","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicroteq%2Femail_notifier","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicroteq%2Femail_notifier/lists"}