Skip to main content
Glama

mcp-ntfy

MCP server for ntfy push notifications. Send and poll notifications from any MCP-compatible client.

Installation

npx mcp-ntfy

Related MCP server: ntfy-me-mcp

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "ntfy": {
      "command": "npx",
      "args": ["-y", "mcp-ntfy"],
      "env": {
        "NTFY_URL": "https://ntfy.sh",
        "NTFY_TOKEN": "tk_...",
        "NTFY_TOPIC": "my-notifications"
      }
    }
  }
}

Claude Code

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "ntfy": {
      "command": "npx",
      "args": ["-y", "mcp-ntfy"],
      "env": {
        "NTFY_URL": "https://ntfy.sh",
        "NTFY_TOKEN": "tk_...",
        "NTFY_TOPIC": "my-notifications"
      }
    }
  }
}

Environment Variables

Variable

Required

Default

Description

NTFY_URL

No

https://ntfy.sh

ntfy server base URL

NTFY_TOKEN

No

Bearer token for authentication

NTFY_TOPIC

No

Default topic (used when tool calls omit topic)

Tools

publish

Send a push notification to an ntfy topic.

Parameter

Type

Required

Description

topic

string

No*

Topic name (*required if NTFY_TOPIC not set)

message

string

Yes

Notification body

title

string

No

Notification title

priority

number

No

1=min, 2=low, 3=default, 4=high, 5=urgent

tags

string[]

No

Emoji shortcodes, e.g. ["warning", "skull"]

click

string

No

URL to open on tap

attach

string

No

File URL to attach

filename

string

No

Attachment filename

icon

string

No

Notification icon URL

delay

string

No

Delay: "30m", "2h", "tomorrow 9am"

markdown

boolean

No

Enable Markdown formatting

actions

Action[]

No

Up to 3 action buttons

poll

Poll for cached messages from an ntfy topic.

Parameter

Type

Required

Description

topic

string

No*

Topic to poll (*required if NTFY_TOPIC not set)

since

string

No

Duration ("10m"), timestamp, ID, "all", or "latest"

scheduled

boolean

No

Include scheduled messages

id

string

No

Filter by message ID

message

string

No

Filter by message text

title

string

No

Filter by title

priority

string

No

Filter by priority (comma-separated)

tags

string

No

Filter by tags (comma-separated, AND logic)

server_health

Check ntfy server health status and message statistics. No parameters.

License

MIT

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mambucodev/mcp-ntfy'

If you have feedback or need assistance with the MCP directory API, please join our Discord server