apprise

apprise-mcp

MCP server and CLI for Apprise — a universal push notification library that supports 80+ services (Slack, Discord, PagerDuty, Gotify, ntfy, Telegram, email, and many more).

What it does

apprise-mcp bridges Claude (and any MCP client) to an Apprise API server so that AI agents can send push notifications as part of their workflows — alerts, status updates, job completions, incident reports.

Architecture

Claude / MCP client
        |
   apprise-mcp (this server)
        |  HTTP REST
   Apprise API server   (http://your-host:8766)
        |
   80+ notification services
   (Slack, Discord, email, ntfy, Gotify, ...)

Quickstart

See docs/QUICKSTART.md for a 5-minute setup guide.

MCP tool: apprise

The server exposes a single apprise tool with an action selector.

notify — send to configured tag (or all services)

{
  "action": "notify",
  "body": "Deployment succeeded",
  "tag": "ops",
  "title": "Deploy complete",
  "type": "success"
}

tag is optional. Omit it to broadcast to all configured services.

notify_url — stateless one-off notification

{
  "action": "notify_url",
  "urls": "slack://tokenA/tokenB/tokenC",
  "body": "Critical error in prod",
  "title": "ALERT",
  "type": "failure"
}

No pre-configuration on the Apprise server required.

health — server health check

{ "action": "health" }

help — inline documentation

{ "action": "help" }

Notification types

type	meaning
info	Informational (default)
success	Successful operation
warning	Non-critical warning
failure	Critical failure / error

CLI

# Send to all services under the "ops" tag
apprise notify "Backup finished" --tag ops --title "Backup" --type success

# Stateless one-off (no server pre-configuration needed)
apprise notify-url "slack://tokenA/tokenB/tokenC" "Hello from CLI"

# Health check
apprise health

# Raw JSON output
apprise health --json

# MCP modes
apprise serve      # HTTP MCP server (default)
apprise mcp        # stdio MCP transport

Environment variables

Variable	Default	Description
APPRISE_URL	http://localhost:8000	Apprise API server URL
APPRISE_TOKEN	(empty)	API token (optional for open installs)
APPRISE_MCP_HOST	0.0.0.0	MCP HTTP bind host
APPRISE_MCP_PORT	8765	MCP HTTP bind port
APPRISE_MCP_TOKEN	(none)	Static bearer token for MCP HTTP auth
RUST_LOG	info	Log filter

Claude Desktop config

{
  "mcpServers": {
    "apprise": {
      "command": "apprise",
      "args": ["mcp"],
      "env": {
        "APPRISE_URL": "http://100.120.242.29:8766"
      }
    }
  }
}

Building

cargo build --release
# Binary: target/release/apprise

Minimum Rust version: 1.86

Apprise API server

This tool connects to a running Apprise API server, not the Python library directly.

Quick start with Docker:

docker run -p 8000:8000 caronc/apprise:latest

The API server lets you pre-configure notification services under named tags via its web UI or REST API, then notify them by tag from apprise-mcp.