Ntfy Push Notification
ntfy_send_notifySend notifications via Ntfy to multiple platforms including Weixin, Telegram, Bark, and Lark with customizable messages, priorities, and actions.
Instructions
Push a notification via Ntfy
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | Notification message body; set to `triggered` if empty or not passed | |
| title | No | Notification title | |
| topic | No | Target topic name or URL | |
| click | No | URL opened when notification is clicked | |
| attach | No | URL of an attachment | |
| icon | No | URL of notification icon | |
| markdown | No | Set to `true` if the message is Markdown-formatted | |
| filename | No | File name of the attachment | |
| priority | No | Message priority with 1=min, 3=default and 5=max | |
| delay | No | Timestamp or duration for delayed delivery. Example: 30min, 9am | |
| actions | No | List of action buttons. The following actions are supported: - view: Opens a website or app when the action button is tapped - broadcast: Sends an Android broadcast intent when the action button is tapped (only supported on Android) - http: Sends HTTP POST/GET/PUT request when the action button is tapped ```json [ { "action": "view", "label": "Open portal", "url": "https://home.nest.com/", "clear": true }, { "action": "http", "label": "Turn down", "url": "https://api.nest.com/", "body": "{"temperature": 65}" }, { "action": "broadcast", "label": "Take picture", "extras": { "cmd": "pic", "camera": "front" } } ] ``` |
Implementation Reference
- mcp_notify/other.py:146-149 (registration)Registers the ntfy_send_notify tool with FastMCP using the @mcp.tool decorator.
@mcp.tool( title="Ntfy Push Notification", description="Push a notification via Ntfy", ) - mcp_notify/other.py:150-187 (handler)The handler function implementing the ntfy_send_notify tool logic, including input schema definitions via Pydantic Field and the HTTP POST request to the Ntfy service.
def ntfy_send_notify( message: str = Field(description="Notification message body; set to `triggered` if empty or not passed"), title: str = Field("", description="Notification title"), topic: str = Field("", description="Target topic name or URL"), click: str = Field("", description="URL opened when notification is clicked"), attach: str = Field("", description="URL of an attachment"), icon: str = Field("", description="URL of notification icon"), markdown: bool = Field(False, description="Set to `true` if the message is Markdown-formatted"), filename: str = Field("", description="File name of the attachment"), priority: int = Field(3, description="Message priority with 1=min, 3=default and 5=max"), delay: str = Field("", description="Timestamp or duration for delayed delivery. Example: 30min, 9am"), actions: list | None = Field(None, description=f"List of action buttons.{NTFY_ACTIONS_RULE}"), ): """ https://docs.ntfy.sh/publish/#publish-as-json """ base = os.getenv("NTFY_BASE_URL") or "https://ntfy.sh" if topic and topic.startswith("http"): base, topic = topic.rsplit("/", 1) if not topic: topic = os.getenv("NTFY_DEFAULT_TOPIC", "") data = { "topic": topic, "title": title, "message": message, "click": click, "icon": icon, "markdown": markdown or False, "priority": priority, "delay": delay, } if attach: data["attach"] = attach data["filename"] = filename if actions: data["actions"] = actions res = requests.post(f"{base}", json=data) return res.json()