n8n-nodes-ntfy-client

About

n8n-nodes-ntfy-client is a community node for n8n that integrates ntfy — a simple HTTP-based pub-sub notification service. It supports both sending notifications and subscribing to topics, with authentication handled in line with n8n conventions.

Works with the public ntfy.sh server and self-hosted instances alike.

Nodes

Ntfy Send

Publishes a notification to an ntfy topic. Runs once per workflow execution.

Parameter	Required	Description
Topic	Yes	Topic name to publish to (e.g. my-alerts)
Message	Yes	Notification body text
Title	No	Notification title
Priority	No	Min (1) / Low (2) / Default (3) / High (4) / Urgent (5)
Tags	No	Comma-separated tags or emoji (e.g. warning,📦)

Ntfy Trigger

Subscribes to one or more ntfy topics using a persistent JSON stream. Triggers the workflow for each incoming message.

Parameter	Required	Description
Topics	Yes	Topic name(s). Use commas for multiple: alerts,backup,system
Since	No	New messages only (default) / Last 10 minutes / Last 1 hour / All cached

Output — the full ntfy message object:

{
  "id": "abc123",
  "time": 1716000000,
  "topic": "alerts",
  "event": "message",
  "message": "Server is down",
  "title": "Alert",
  "priority": 5,
  "tags": ["warning"]
}

On connection loss the trigger reconnects automatically with exponential backoff (up to 5 retries). Authentication errors (401/403) surface immediately without retrying.

Authentication (Ntfy API)

After installing, create a new credential of type Ntfy API:

Field	Description
Server URL	https://ntfy.sh for the public server, or your self-hosted address
Authentication Type	None / Basic Auth / Access Token
Username / Password	Shown when Basic Auth is selected
Access Token	Shown when Access Token is selected

The credential is tested automatically against GET /v1/health when saved.

Installation

In your n8n instance go to Settings → Community Nodes → Install and enter:

n8n-nodes-ntfy-client

Requirements

• n8n >=1.0.0
• ntfy server (self-hosted or public ntfy.sh)

License

MIT