A simple MCP (Model Context Protocol) server for sending push notifications via ntfy.sh. Works seamlessly with Claude Desktop and other MCP-compatible clients.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add simple-ntfy --env NTFY_DEFAULT_TOPIC='<NTFY_DEFAULT_TOPIC>' -- npx -y simple-ntfy-mcp~/.codex/config.toml
[mcp_servers.simple-ntfy]
command = "npx"
args = ["-y", "simple-ntfy-mcp"]
env = { NTFY_DEFAULT_TOPIC = "<NTFY_DEFAULT_TOPIC>" }
# codex mcp add simple-ntfy --env NTFY_DEFAULT_TOPIC='<NTFY_DEFAULT_TOPIC>' -- npx -y simple-ntfy-mcp~/.cursor/mcp.json
{
"mcpServers": {
"simple-ntfy": {
"command": "npx",
"args": [
"-y",
"simple-ntfy-mcp"
],
"env": {
"NTFY_DEFAULT_TOPIC": "<NTFY_DEFAULT_TOPIC>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"simple-ntfy": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"simple-ntfy-mcp"
],
"env": {
"NTFY_DEFAULT_TOPIC": "<NTFY_DEFAULT_TOPIC>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"simple-ntfy": {
"command": "npx",
"args": [
"-y",
"simple-ntfy-mcp"
],
"env": {
"NTFY_DEFAULT_TOPIC": "<NTFY_DEFAULT_TOPIC>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"simple-ntfy": {
"command": "npx",
"args": [
"-y",
"simple-ntfy-mcp"
],
"env": {
"NTFY_DEFAULT_TOPIC": "<NTFY_DEFAULT_TOPIC>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"simple-ntfy": {
"command": "npx",
"args": [
"-y",
"simple-ntfy-mcp"
],
"env": {
"NTFY_DEFAULT_TOPIC": "<NTFY_DEFAULT_TOPIC>"
}
}
}
}Environment variables
NTFY_DEFAULT_TOPIC
Replace the placeholders with your own credentials and keep them out of version control.