name: ntfy description: Send push notifications to phones/desktops via ntfy. Use when the user wants to send alerts, reminders, or notifications. category: comms maturity: stable tags: [push-notifications, ntfy, alerts, curl, reminders]
ntfy Push Notifications
Send notifications to the user's phone/desktop:
# Simple notification
curl -d "MESSAGE" ntfy.sh/TOPIC
# With title and priority
curl -H "Title: TITLE" -H "Priority: high" -d "MESSAGE" ntfy.sh/TOPIC
# With tags/emoji
curl -H "Tags: warning,skull" -d "MESSAGE" ntfy.sh/TOPIC
# With click URL
curl -H "Click: https://example.com" -d "MESSAGE" ntfy.sh/TOPIC
Priority Levels
min/low/default/high/urgenturgentbypasses DND on phone
Tags (emoji shortcodes)
Common: warning, white_check_mark, rotating_light, chart_with_upwards_trend, robot
Notes
- Free tier: 250 messages/day per IP
- No API key needed for ntfy.sh
- Topic = channel name (create any name, it's public unless self-hosted)
- Use a unique/random topic name for privacy