How do I install the Ntfy Notify skill?

Run npx skillmds add majiayu000/ntfy-notify in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ntfy Notify safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ntfy Notify?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ntfy Notify free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ntfy Notify?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ntfy Notify by majiayu000 — Agent Skill

Name: Ntfy Notify
Rating: 4.2 (5 reviews)
Author: majiayu000

File contents

ntfy.sh Notifications

Send push notifications to the user's device via ntfy.sh.

Configuration

Topic: YOUR_TOPIC
Endpoint: https://ntfy.sh/YOUR_TOPIC

How to Send Notifications

Use curl to send a notification:

curl -d "Your message here" ntfy.sh/YOUR_TOPIC

With a Title

curl -H "Title: Task Complete" -d "Your message here" ntfy.sh/YOUR_TOPIC

With Priority

Priority levels: min, low, default, high, urgent

curl -H "Priority: high" -d "Your message here" ntfy.sh/YOUR_TOPIC

With Tags/Emojis

curl -H "Tags: white_check_mark" -d "Build succeeded" ntfy.sh/YOUR_TOPIC

Click Actions (Deeplinks)

Make the notification clickable - tapping it opens a URL or deeplink.

curl -H "Click: https://example.com" -d "Click to open" ntfy.sh/YOUR_TOPIC

Supports any URI scheme: https://, mailto:, app deeplinks, etc.

Action Buttons

Add up to 3 interactive buttons to notifications. Separate multiple actions with semicolons.

View Action (Open URL/App)

curl \
  -H "Actions: view, Open Link, https://example.com" \
  -d "Check this out" ntfy.sh/YOUR_TOPIC

HTTP Action (Trigger API)

curl \
  -H "Actions: http, Run Build, https://api.example.com/build, method=POST" \
  -d "Ready to deploy?" ntfy.sh/YOUR_TOPIC

Multiple Actions

curl \
  -H "Actions: view, View Logs, https://logs.example.com; http, Retry, https://api.example.com/retry, method=POST" \
  -d "Build failed" ntfy.sh/YOUR_TOPIC

Action Format

<type>, <label>, <url>, [options]

type: view or http
label: Button text
url: Target URL or deeplink
options: method=POST, body={"key":"value"}, clear=true

Combined Example

curl \
  -H "Title: Deploy Complete" \
  -H "Tags: rocket" \
  -H "Priority: high" \
  -H "Click: https://app.example.com" \
  -H "Actions: view, View Site, https://app.example.com; view, View Logs, https://logs.example.com" \
  -d "Production deployment finished successfully" \
  ntfy.sh/YOUR_TOPIC

When to Use

After completing a long-running task (builds, tests, deployments)
When an error occurs that needs attention
When user explicitly asks to be notified
When waiting for user input after completing work

Example Messages

Task completion: "Build completed successfully"
Error alert: "Build failed: 3 type errors found"
Status update: "Deployment to staging complete"

---name: ntfy-notifydescription: Send push notifications via ntfy.sh. Use this skill when the user asks to be notified, wants an alert, or when a long-running task completes and the user should be informed.--- # ntfy.sh Notifications Send push notifications to the user's device via ntfy.sh. ## Configuration - **Topic**: `YOUR_TOPIC` - **Endpoint**: `https://ntfy.sh/YOUR_TOPIC` ## How to Send Notifications Use curl to send a notification: ```bash curl -d "Your message here" ntfy.sh/YOUR_TOPIC ``` ### With a Title ```bash curl -H "Title: Task Complete" -d "Your message here" ntfy.sh/YOUR_TOPIC ``` ### With Priority Priority levels: `min`, `low`, `default`, `high`, `urgent` ```bash curl -H "Priority: high" -d "Your message here" ntfy.sh/YOUR_TOPIC ``` ### With Tags/Emojis ```bash curl -H "Tags: white_check_mark" -d "Build succeeded" ntfy.sh/YOUR_TOPIC ``` ## Click Actions (Deeplinks) Make the notification clickable - tapping it opens a URL or deeplink. ```bash curl -H "Click: https://example.com" -d "Click to open" ntfy.sh/YOUR_TOPIC ``` Supports any URI scheme: `https://`, `mailto:`, app deeplinks, etc. ## Action Buttons Add up to 3 interactive buttons to notifications. Separate multiple actions with semicolons. ### View Action (Open URL/App) ```bash curl \ -H "Actions: view, Open Link, https://example.com" \ -d "Check this out" ntfy.sh/YOUR_TOPIC ``` ### HTTP Action (Trigger API) ```bash curl \ -H "Actions: http, Run Build, https://api.example.com/build, method=POST" \ -d "Ready to deploy?" ntfy.sh/YOUR_TOPIC ``` ### Multiple Actions ```bash curl \ -H "Actions: view, View Logs, https://logs.example.com; http, Retry, https://api.example.com/retry, method=POST" \ -d "Build failed" ntfy.sh/YOUR_TOPIC ``` ### Action Format ``` <type>, <label>, <url>, [options] ``` - **type**: `view` or `http` - **label**: Button text - **url**: Target URL or deeplink - **options**: `method=POST`, `body={"key":"value"}`, `clear=true` ## Combined Example ```bash curl \ -H "Title: Deploy Complete" \ -H "Tags: rocket" \ -H "Priority: high" \ -H "Click: https://app.example.com" \ -H "Actions: view, View Site, https://app.example.com; view, View Logs, https://logs.example.com" \ -d "Production deployment finished successfully" \ ntfy.sh/YOUR_TOPIC ``` ## When to Use - After completing a long-running task (builds, tests, deployments) - When an error occurs that needs attention - When user explicitly asks to be notified - When waiting for user input after completing work ## Example Messages - Task completion: "Build completed successfully" - Error alert: "Build failed: 3 type errors found" - Status update: "Deployment to staging complete"

Frequently asked questions