• MOBILE
  • DESKTOP
  • LOGS
  • HUMAN

How to send push notifications with your AI

Connect ntfy to your agent to turn text outputs into instant mobile or desktop alerts. Once connected, your AI can ping you whenever it finishes a task or hits a specific condition.

Ask AI about this page

Short answer

How can my AI send me push notifications?

Your AI uses the ntfy connector to trigger alerts through the publish_message tool. You just tell your agent what to watch for, and it sends a message to your chosen ntfy topic. This setup lets you receive updates on your phone or desktop without checking your chat client constantly.

Notification outcomes

Where alerts land

What happens when your AI triggers an alert.

MOBILE

Phone alerts

The AI sends a message to a specific ntfy topic. You get a standard push notification on your mobile device via the ntfy app.

DESKTOP

Browser pings

Your agent pushes updates to your desktop. You see these as system notifications or browser alerts depending on your setup.

LOGS

Status updates

The AI can send periodic summaries of its progress. This keeps you informed on long-running tasks without manual check-ins.

HUMAN

Requires your input

The AI sends the alert, but you decide how to react. It cannot open apps or click buttons on your phone for you.

The workflow

What your AI does when <the thing arrives>.

The AI handles the communication bridge between its logic and your device.

  1. Monitor conditions

    Your agent watches your data, files, or chat history for specific triggers you defined.

    publish_message

  2. Format the alert

    The AI writes a concise message containing the relevant details from the trigger event.

    publish_message

  3. Trigger the push

    The agent calls the ntfy service to deliver the message to your specific topic.

    publish_message

  4. Confirm delivery

    The AI verifies the message was sent successfully before moving to the next task.

    publish_message

Try it

Copy these to start.

Use these prompts to get your AI moving.

Starting points

Swap out the topic names and the specific triggers to match your ntfy setup.

ntfy Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_ktVeENNHwfdlOfmq0cVOwgX6JIkWtDxTzBj8FeX6/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — ntfy capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "ntfy-push-notifications-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_ktVeENNHwfdlOfmq0cVOwgX6JIkWtDxTzBj8FeX6/mcp"
    }
  }
}
Copy into chat04

  • Send a push notification to the 'my-alerts' topic when the weather forecast changes.

  • Notify my ntfy topic 'dev-updates' every time a new commit is pushed to the main branch.

  • Ping my phone via ntfy when you finish analyzing the data in this spreadsheet.

  • Send a message to the 'urgent-tasks' topic if you detect any errors in the logs.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect ntfy once, then ask.

One click connects the MCP to your client. Your credentials stay encrypted and secure on our side.

Connect ntfy to your AI

FAQ

How this task behaves

  • 01

    Can the AI send images in the notification?

    No. The current tool only supports sending text messages through the publish_message action.

  • 02

    Does the AI decide which topic to use?

    You must tell the AI which ntfy topic to use in your prompt, or it will ask you for one.

  • 03

    Can the AI read my incoming push notifications?

    No. The AI can only send messages out to ntfy. It cannot listen to or intercept notifications sent to your phone.

  • 04

    Will the AI delete my ntfy topics?

    No. The AI only has permission to publish messages. It cannot create, modify, or delete topics in ntfy.

  • 05

    Do I need to install anything on my phone?

    Yes, you will need the ntfy app installed on your mobile device to receive the alerts the AI sends.

  • More questions about ntfy? The Connector page answers them. See everything the ntfy Connector can do

Connect ntfy to Claude, Cursor, ChatGPT & more