ntfy-mcp-server

Overview

ntfy-mcp-server provides comprehensive tools for interacting with ntfy push notification service through the Model Context Protocol. It includes four main tools: publishing messages with full parameter coverage, managing existing notifications, fetching cached messages with filters, and searching emoji tags. Built on @cyanheads/mcp-ts-core, it supports multiple authentication methods (JWT, OAuth) and storage backends (in-memory, filesystem, Supabase, Cloudflare). The server offers both STDIO and HTTP transports, with configurable authentication and robust error handling.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• ntfy_publish_message

  Send or update a push notification on an ntfy topic.

  Try:Send a notification to the 'alerts' topic with high priorityTry:Publish a message with action buttons and tagsTry:Update an existing notification using its sequence ID
• ntfy_manage_message

  Clear or delete a previously-sent notification by sequence_id.

  Try:Clear notification with sequence ID 12345Try:Delete old notification from the backups topic
• ntfy_fetch_messages

  Poll cached messages from one or more topics with optional filters.

  Try:Fetch messages from the alerts topic since yesterdayTry:Get all high priority messages from multiple topicsTry:Retrieve the latest 20 messages from the backups topic
• ntfy_search_emoji_tags

  Look up ntfy emoji tag short codes for use in tags.

  Try:Search for alert-related emojisTry:Find notification tags with rocket iconTry:Get all available emoji tags

Comparable tools

Installation

bunx ntfy-mcp-server@latest

{
  "mcpServers": {
    "ntfy": {
      "type": "stdio",
      "command": "bunx",
      "args": ["ntfy-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info",
        "NTFY_DEFAULT_TOPIC": "your-topic-name"
      }
    }
  }
}

{
  "mcpServers": {
    "ntfy": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MCP_TRANSPORT_TYPE=stdio",
        "-e", "NTFY_DEFAULT_TOPIC=your-topic-name",
        "ghcr.io/cyanheads/ntfy-mcp-server:latest"
      ]
    }
  }
}

FAQ

How do I authenticate with a self-hosted ntfy server?

Set NTFY_BASE_URL to your server's address and provide either NTFY_AUTH_TOKEN (bearer token) or both NTFY_AUTH_USERNAME and NTFY_AUTH_PASSWORD for basic authentication.

Can I manage multiple ntfy servers simultaneously?

Yes, use the NTFY_SERVERS environment variable with JSON array entries containing baseUrl and optional auth credentials for each server.

Compare ntfy-mcp-server with