ntfy-mcp-server

What this does

ntfy-mcp-server exposes a set of tools to Claude over the Model Context Protocol. After you add it to claude_desktop_config.json (snippet above) and restart Claude Desktop, those tools become callable inside any conversation.

Requirements

This server declares the following environment variables. Set only the ones the maker requires for your setup; this listing does not flag any of them as required:

NTFY_SERVERS
NTFY_BASE_URL
NTFY_DEFAULT_TOPIC
NTFY_AUTH_TOKEN
NTFY_AUTH_USERNAME
NTFY_AUTH_PASSWORD
NTFY_REQUEST_TIMEOUT_MS
NTFY_MAX_RETRIES
NTFY_BLOCK_PRIVATE_HOSTS
NTFY_ENABLE_EMOJI_TAGS
MCP_LOG_LEVEL
LOGS_DIR
OTEL_ENABLED

Set these via the env object in your MCP config (see claude_desktop_config.json snippet above).

How do I install ntfy-mcp-server?

Run the Claude Code command in the install section to add ntfy-mcp-server to Claude Code, or copy the ready-made config for your client from the install section on this page. Restart your client afterwards and the tools appear in your next conversation.

Which clients work with ntfy-mcp-server?

This page carries setup and config for Claude Code, Claude Desktop, Cursor and VS Code. Any other MCP client that accepts a standard server config can connect to ntfy-mcp-server as well.

Does ntfy-mcp-server need an API key?

This listing does not flag an API key as required. The server can use these environment variables: NTFY_SERVERS, NTFY_BASE_URL, NTFY_DEFAULT_TOPIC, NTFY_AUTH_TOKEN, NTFY_AUTH_USERNAME, NTFY_AUTH_PASSWORD, NTFY_REQUEST_TIMEOUT_MS, NTFY_MAX_RETRIES, NTFY_BLOCK_PRIVATE_HOSTS, NTFY_ENABLE_EMOJI_TAGS, MCP_LOG_LEVEL, LOGS_DIR, OTEL_ENABLED; the maker's docs say which of them your setup needs. They go in the env block of your MCP config.