ntfy
Publish ntfy notifications, read the message cache, and manage users and topic access
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.3.0
- Listing updated
- 5 days ago
About ntfy
ntfy is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add ntfy-mcp --env NTFY_URL='<NTFY_URL>' --env NTFY_TOKEN='<NTFY_TOKEN>' --env NTFY_PASSWORD='<NTFY_PASSWORD>' -- npx -y @ni-c/ntfy-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"ntfy-mcp": {
"command": "npx",
"args": [
"-y",
"@ni-c/ntfy-mcp"
],
"env": {
"NTFY_URL": "<NTFY_URL>",
"NTFY_TOKEN": "<NTFY_TOKEN>",
"NTFY_PASSWORD": "<NTFY_PASSWORD>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ntfy-mcp": {
"command": "npx",
"args": [
"-y",
"@ni-c/ntfy-mcp"
],
"env": {
"NTFY_URL": "<NTFY_URL>",
"NTFY_TOKEN": "<NTFY_TOKEN>",
"NTFY_PASSWORD": "<NTFY_PASSWORD>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"ntfy-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ni-c/ntfy-mcp"
],
"env": {
"NTFY_URL": "<NTFY_URL>",
"NTFY_TOKEN": "<NTFY_TOKEN>",
"NTFY_PASSWORD": "<NTFY_PASSWORD>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"ntfy-mcp": {
"command": "npx",
"args": [
"-y",
"@ni-c/ntfy-mcp"
],
"env": {
"NTFY_URL": "<NTFY_URL>",
"NTFY_TOKEN": "<NTFY_TOKEN>",
"NTFY_PASSWORD": "<NTFY_PASSWORD>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"ntfy-mcp": {
"command": "npx",
"args": [
"-y",
"@ni-c/ntfy-mcp"
],
"env": {
"NTFY_URL": "<NTFY_URL>",
"NTFY_TOKEN": "<NTFY_TOKEN>",
"NTFY_PASSWORD": "<NTFY_PASSWORD>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
NTFY_URLBase URL of the ntfy server, e.g. https://ntfy.example.net. There is deliberately no default.RequiredNTFY_TOKENntfy access token (tk_...). Optional: an open instance needs no credentials. Mutually exclusive with NTFY_USERNAME/NTFY_PASSWORD.NTFY_USERNAMEUsername for basic authentication. Must be set together with NTFY_PASSWORD.NTFY_PASSWORDPassword for basic authentication. Must be set together with NTFY_USERNAME.NTFY_TOPICSComma-separated topics the server may use. The first is the default when a tool omits one, and the list restricts every read and write tool.NTFY_READ_ONLYSet to exactly true to register only the six read tools (default: false — ntfy exists to publish)NTFY_INSECURE_TLSSet to true to accept a self-signed certificate from the ntfy server (default: false)NTFY_ALLOW_TOOLSComma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)NTFY_DENY_TOOLSComma-separated tool names or list_* prefixes to remove from whatever the allow list leftNTFY_URLBase URL of the ntfy server, e.g. https://ntfy.example.net. There is deliberately no default.RequiredNTFY_TOKENntfy access token (tk_...). Optional: an open instance needs no credentials. Mutually exclusive with NTFY_USERNAME/NTFY_PASSWORD.NTFY_USERNAMEUsername for basic authentication. Must be set together with NTFY_PASSWORD.NTFY_PASSWORDPassword for basic authentication. Must be set together with NTFY_USERNAME.NTFY_TOPICSComma-separated topics the server may use. The first is the default when a tool omits one, and the list restricts every read and write tool.NTFY_READ_ONLYSet to exactly true to register only the six read tools (default: false — ntfy exists to publish)NTFY_INSECURE_TLSSet to true to accept a self-signed certificate from the ntfy server (default: false)NTFY_ALLOW_TOOLSComma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)NTFY_DENY_TOOLSComma-separated tool names or list_* prefixes to remove from whatever the allow list left
Pricing
Open source
Prices change. Check ntfy-mcp.ni-c.de before you buy.
ntfy FAQ
Is ntfy free?
Yes. ntfy is open source, so you can use and self-host it for free.
How do I add ntfy to Claude Code?
Run this command in your terminal: claude mcp add ntfy-mcp --env NTFY_URL='<NTFY_URL>' --env NTFY_TOKEN='<NTFY_TOKEN>' --env NTFY_PASSWORD='<NTFY_PASSWORD>' -- npx -y @ni-c/ntfy-mcp
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.