[APP][Pro] Mail hook

Apps
,
1

Mail Hook - Trigger Flows when new emails arrive via IMAP

This app triggers Homey Flows when new emails arrive in a configured IMAP inbox. It’s perfect for integrating incoming email events with smart home automations, such as notifying you when a specific sender messages you, running actions when a delivery notice arrives, or automating responses to important emails.

Triggers

A new email is received

Triggers when a new email arrives in the configured IMAP inbox. Provides the sender address, subject and body as tokens.

Settings

Configure your IMAP server details:

  • Host (e.g. imap.gmail.com)
  • Port (usually 993 for IMAPS)
  • Username and password
  • TLS toggle
  • Poll interval (seconds)

Includes a Test connection button to validate your IMAP credentials.

Tokens

  • Account name (work)
  • From (email) - sender@example.com
  • From (name) - John Doe
  • Email subject - Your package has been shipped
  • Email body - Dear customer, your order is on its way…

Examples

WHEN a new email is received, AND from_email contains “amazon”, THEN send notification “Package update received”

WHEN a new email is received, AND subject contains “security alert”, THEN turn on security lights

WHEN a new email is received, AND body contains “meeting tomorrow”, THEN add calendar reminder

Acknowledgements

Built using the Homey Apps SDK v3 and Node.js IMAP libraries.

Supported Languages

  • :uk: English
  • :netherlands: Dutch
  • :fr: French
  • :de: German

Donation

If you appreciate this app, contribute to future development by making a
paypal donate kopie

Or use QR Code:

paypal
paypal128×128 1.88 KB

Links

GitHub Repository: https://github.com/elmarkou/homey.mail.hook

Homey App Store: https://homey.app/en-us/app/mail.hook/Mail-Hook/

Documentation: https://github.com/elmarkou/homey.mail.hook#readme

Support: Issues · elmarkou/homey.mail.hook · GitHub

Screenshots

Settings
Settings1290×2796 174 KB

Cards
Cards1290×1136 82 KB

Tokens
Tokens418×309 18.5 KB

Usage

  1. Install the Mail Hook app on your Homey
  2. Configure your IMAP settings in the app settings
  3. Test the connection to ensure it works
  4. Create flows using the “A new email is received” trigger
  5. Use the provided tokens in conditions, notifications, or other actions

Done!

Release Notes

Latest 1.1.1
Test 1.1.1

changelog on app page

2

gives back a 404.

3

Correct its prod link buts its not approved yet. Changed to test url

4

Hi Elmar,

Please use English screenshots in English topics for all the non-Dutch out there.
In case you don’t want to change Homey’s language just to create screenshots,
Google Lens can translate text on images very well. An example, SE to EN:

Screenshot_20260410_231737_Google
Screenshot_20260410_231737_Google1077×2383 136 KB

5

test gives also back a 404

6

Fixed

7

The app is approved and Live!

8

Got a nice suggestion about multiple accounts. So this is now available for test:

9

And it’s live

10

hi @Elmar

could you please check not possible install on homey pro 2019 · Issue #1 · elmarkou/homey.mail.hook · GitHub

11

Hi @Elmar, same problem here not possible to install on Homey 2019, Software Version 13.1.2.

When I go to the app store and select my Homey to install, it says the app will be installed shortly, but nothing happens on my Homey. The app doesn’t install.

The other email app from Adam Noren don’t work anymore on Homey 2019, I use this longtime but don’t work anymore.

12

That app installs and works fine on my Pro 2019 v13.1.2 :man_shrugging:
So I think the issue is, it depends on the mail provider you use → at least Gmail doesn’t work (anylonger), even when using Googles’ “app passwords”.

Confirmed.
The Mail Hook indeed seems to get installed on my Pro 2019, the blue LED ring even turns for a while, but there’s no app to be found.

13

Hi Elmar,

Also posted as reply on the github issue;
After using the CLI homey app run command, this seems to quit the installation process on 2019 models:
✖ request to https://192-168-2-107.homey.homeylocal.com/api/manager/devkit/ failed, reason: unable to get local issuer certificate

It quits right after this error message.

14

Replied here

This is the most common fix for the Homey 2019.

• Tell them: “Unplug your Homey Pro from the power for at least 11 minutes. Do not just restart it via the app; it must be physically unplugged. This forces the security certificate to reset.”

Step 2: Use the Mobile App (Not a Browser)

If they are trying to click “Install” on a laptop browser, the browser’s security settings are likely blocking the request.

• Tell them: “Try to open the installation link on your phone instead of a computer, and make sure your phone is on the same Wi-Fi as the Homey. The mobile app handles security certificates differently than Chrome or Edge.”

Step 3: Disable “Private DNS” or VPN

If the user has a VPN active on their phone/computer, or a feature like “Private DNS” (common on Android), it will prevent the 192-168-x-x.homeylocal.com address from working.

• Tell them: “Turn off any VPNs or Ad-Blockers (like Pi-hole or AdGuard) temporarily while clicking Install.”