Node-RED nodes to send notifications to a Gotify server
npm install node-red-contrib-gotify-notificationsNode-RED nodes for working with a Gotify self-hosted notification server.
This module provides:
- Gotify Server config – holds the base URL and optional port of your Gotify server.
- Gotify Apps config – holds App tokens, used for sending notifications.
- Gotify Clients config – holds Client tokens, used for subscribing to notifications.
- Gotify Send node – publishes notifications to a Gotify App.
- Gotify Subscribe node – listens for incoming notifications from a Gotify server.
There are other nodes for Gotify available, but I created this one to make the setup of servers, applications, and clients
more user-friendly and also to simplify the use of message extras like click URL, bigImage, and markdown formatting.
---
From your Node-RED user directory (usually ~/.node-red), run:
npm install node-red-contrib-gotify-notifications
Restart Node-RED and the nodes will appear in the Gotify category of the palette.
---
http://gotify.lan or https://example.com/gotify. /stream or /ws in the URL.---
The gotify-send node publishes messages to a Gotify App.
msg.title). msg.payload or msg.message). msg.priority). text/markdown; if false, text/plain. Overridden by msg.markdown. msg.bigimage). msg.payload or msg.message → message content msg.title → optional message title msg.priority → priority (integer) msg.markdown → boolean, true = Markdown, false = Plain text msg.bigimage → optional image URL ---
The gotify-subscribe node connects to a Gotify server and listens for notifications in real time using WebSockets.
msg.payload. Example shape: {
"payload": {
"id": 123,
"appid": 4,
"message": "Hello from Gotify!",
"title": "Greeting",
"priority": 5,
"extras": { },
"date": "2025-09-20T12:34:56Z"
}
}
---
Gotify has two types of tokens, and it’s important to use the right one:
- App tokens → used by Send node (publishing).
- Client tokens → used by Subscribe node (listening).
Using an App token with Subscribe will result in “unauthorized” errors.
---
MIT