NotifyHub — Claude Code MCP server: what it does, how to install
Dispatches messages across 23 communication channels using 36 built-in tools. Handy when an assistant needs to send emails or chat alerts.
claude mcp add --env NOTIFY_CHANNELS_EMAIL_HOST=<NOTIFY_CHANNELS_EMAIL_HOST> --env NOTIFY_CHANNELS_EMAIL_PORT=<NOTIFY_CHANNELS_EMAIL_PORT> --env NOTIFY_CHANNELS_EMAIL_USERNAME=<NOTIFY_CHANNELS_EMAIL_USERNAME> --env NOTIFY_CHANNELS_EMAIL_PASSWORD=<NOTIFY_CHANNELS_EMAIL_PASSWORD> --env NOTIFY_CHANNELS_EMAIL_FROM=<NOTIFY_CHANNELS_EMAIL_FROM> --transport stdio notifyhub-unified-notification-mcp-server -- docker run -i --rm -e NOTIFY_CHANNELS_EMAIL_HOST -e NOTIFY_CHANNELS_EMAIL_PORT -e NOTIFY_CHANNELS_EMAIL_USERNAME -e NOTIFY_CHANNELS_EMAIL_PASSWORD -e NOTIFY_CHANNELS_EMAIL_FROM ghcr.io/gabrielbbaldez/notify-hub:1.1.0What NotifyHub — Unified Notification MCP Server does
NotifyHub acts as a centralized notification gateway for coding agents. It provides 36 tools that talk to Telegram, Slack, Discord, and standard email. You interact with one consistent interface instead of wiring distinct SDKs for every messaging provider.
The architecture includes automatic fallback routing. If an email fails, delivery can switch directly to an SMS channel. Mustache templating, locale resolution, exponential retry backoff, and dead-letter queues help handle production workloads reliably.
Running the server requires Docker on the host machine because the runtime runs via ghcr.io/gabrielbbaldez/notify-hub:1.1.0. Missing SMTP environment variables will block email tools immediately.
What it helps with
- deliver alerts to Telegram, Slack, or Discord channels
- route failed email messages automatically to an SMS fallback
- send transactional notifications using Mustache templates
- dispatch asynchronous messages with retry backoff
Example prompts for the agent
- Send a test email to [email protected] with the subject System Update.
- Deliver an urgent alert to our Slack channel and fall back to SMS if it fails.
- Schedule a notification batch using the order confirmation template.
How to install NotifyHub — Unified Notification MCP Server
Platform CLI
claude mcp add --env NOTIFY_CHANNELS_EMAIL_HOST=<NOTIFY_CHANNELS_EMAIL_HOST> --env NOTIFY_CHANNELS_EMAIL_PORT=<NOTIFY_CHANNELS_EMAIL_PORT> --env NOTIFY_CHANNELS_EMAIL_USERNAME=<NOTIFY_CHANNELS_EMAIL_USERNAME> --env NOTIFY_CHANNELS_EMAIL_PASSWORD=<NOTIFY_CHANNELS_EMAIL_PASSWORD> --env NOTIFY_CHANNELS_EMAIL_FROM=<NOTIFY_CHANNELS_EMAIL_FROM> --transport stdio notifyhub-unified-notification-mcp-server -- docker run -i --rm -e NOTIFY_CHANNELS_EMAIL_HOST -e NOTIFY_CHANNELS_EMAIL_PORT -e NOTIFY_CHANNELS_EMAIL_USERNAME -e NOTIFY_CHANNELS_EMAIL_PASSWORD -e NOTIFY_CHANNELS_EMAIL_FROM ghcr.io/gabrielbbaldez/notify-hub:1.1.0Replace <…> with your own values. 45 more environment variables are in the server README
Platform CLI
codex mcp add notifyhub-unified-notification-mcp-server --env NOTIFY_CHANNELS_EMAIL_HOST=<NOTIFY_CHANNELS_EMAIL_HOST> --env NOTIFY_CHANNELS_EMAIL_PORT=<NOTIFY_CHANNELS_EMAIL_PORT> --env NOTIFY_CHANNELS_EMAIL_USERNAME=<NOTIFY_CHANNELS_EMAIL_USERNAME> --env NOTIFY_CHANNELS_EMAIL_PASSWORD=<NOTIFY_CHANNELS_EMAIL_PASSWORD> --env NOTIFY_CHANNELS_EMAIL_FROM=<NOTIFY_CHANNELS_EMAIL_FROM> -- docker run -i --rm -e NOTIFY_CHANNELS_EMAIL_HOST -e NOTIFY_CHANNELS_EMAIL_PORT -e NOTIFY_CHANNELS_EMAIL_USERNAME -e NOTIFY_CHANNELS_EMAIL_PASSWORD -e NOTIFY_CHANNELS_EMAIL_FROM ghcr.io/gabrielbbaldez/notify-hub:1.1.0Replace <…> with your own values. 45 more environment variables are in the server README
Config file
{
"mcpServers": {
"notifyhub-unified-notification-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"NOTIFY_CHANNELS_EMAIL_HOST",
"-e",
"NOTIFY_CHANNELS_EMAIL_PORT",
"-e",
"NOTIFY_CHANNELS_EMAIL_USERNAME",
"-e",
"NOTIFY_CHANNELS_EMAIL_PASSWORD",
"-e",
"NOTIFY_CHANNELS_EMAIL_FROM",
"ghcr.io/gabrielbbaldez/notify-hub:1.1.0"
],
"env": {
"NOTIFY_CHANNELS_EMAIL_HOST": "<NOTIFY_CHANNELS_EMAIL_HOST>",
"NOTIFY_CHANNELS_EMAIL_PORT": "<NOTIFY_CHANNELS_EMAIL_PORT>",
"NOTIFY_CHANNELS_EMAIL_USERNAME": "<NOTIFY_CHANNELS_EMAIL_USERNAME>",
"NOTIFY_CHANNELS_EMAIL_PASSWORD": "<NOTIFY_CHANNELS_EMAIL_PASSWORD>",
"NOTIFY_CHANNELS_EMAIL_FROM": "<NOTIFY_CHANNELS_EMAIL_FROM>"
}
}
}
}Replace <…> with your own values. 45 more environment variables are in the server README
Config file
{
"servers": {
"notifyhub-unified-notification-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"NOTIFY_CHANNELS_EMAIL_HOST",
"-e",
"NOTIFY_CHANNELS_EMAIL_PORT",
"-e",
"NOTIFY_CHANNELS_EMAIL_USERNAME",
"-e",
"NOTIFY_CHANNELS_EMAIL_PASSWORD",
"-e",
"NOTIFY_CHANNELS_EMAIL_FROM",
"ghcr.io/gabrielbbaldez/notify-hub:1.1.0"
],
"env": {
"NOTIFY_CHANNELS_EMAIL_HOST": "<NOTIFY_CHANNELS_EMAIL_HOST>",
"NOTIFY_CHANNELS_EMAIL_PORT": "<NOTIFY_CHANNELS_EMAIL_PORT>",
"NOTIFY_CHANNELS_EMAIL_USERNAME": "<NOTIFY_CHANNELS_EMAIL_USERNAME>",
"NOTIFY_CHANNELS_EMAIL_PASSWORD": "<NOTIFY_CHANNELS_EMAIL_PASSWORD>",
"NOTIFY_CHANNELS_EMAIL_FROM": "<NOTIFY_CHANNELS_EMAIL_FROM>"
}
}
}
}Replace <…> with your own values. 45 more environment variables are in the server README
Platform CLI
gemini mcp add -e NOTIFY_CHANNELS_EMAIL_HOST=<NOTIFY_CHANNELS_EMAIL_HOST> -e NOTIFY_CHANNELS_EMAIL_PORT=<NOTIFY_CHANNELS_EMAIL_PORT> -e NOTIFY_CHANNELS_EMAIL_USERNAME=<NOTIFY_CHANNELS_EMAIL_USERNAME> -e NOTIFY_CHANNELS_EMAIL_PASSWORD=<NOTIFY_CHANNELS_EMAIL_PASSWORD> -e NOTIFY_CHANNELS_EMAIL_FROM=<NOTIFY_CHANNELS_EMAIL_FROM> notifyhub-unified-notification-mcp-server docker run -i --rm -e NOTIFY_CHANNELS_EMAIL_HOST -e NOTIFY_CHANNELS_EMAIL_PORT -e NOTIFY_CHANNELS_EMAIL_USERNAME -e NOTIFY_CHANNELS_EMAIL_PASSWORD -e NOTIFY_CHANNELS_EMAIL_FROM ghcr.io/gabrielbbaldez/notify-hub:1.1.0Replace <…> with your own values. 45 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about NotifyHub — Unified Notification MCP Server
How to install NotifyHub in Claude Code?
Run `claude mcp add --env NOTIFY_CHANNELS_EMAIL_HOST=<NOTIFY_CHANNELS_EMAIL_HOST> --env NOTIFY_CHANNELS_EMAIL_PORT=<NOTIFY_CHANNELS_EMAIL_PORT> --env NOTIFY_CHANNELS_EMAIL_USERNAME=<NOTIFY_CHANNELS_EMAIL_USERNAME> --env NOTIFY_CHANNELS_EMAIL_PASSWORD=<NOTIFY_CHANNELS_EMAIL_PASSWORD> --env NOTIFY_CHANNELS_EMAIL_FROM=<NOTIFY_CHANNELS_EMAIL_FROM> --transport stdio notifyhub-unified-notification-mcp-server -- docker run -i --rm -e NOTIFY_CHANNELS_EMAIL_HOST -e NOTIFY_CHANNELS_EMAIL_PORT -e NOTIFY_CHANNELS_EMAIL_USERNAME -e NOTIFY_CHANNELS_EMAIL_PASSWORD -e NOTIFY_CHANNELS_EMAIL_FROM ghcr.io/gabrielbbaldez/notify-hub:1.1.0`.
What does NotifyHub do?
It gives the AI assistant tools to send messages across 23 different channels, covering chat platforms, email, and webhooks.
What are the prerequisites to run this server?
You need a local Docker daemon running and valid credentials passed through environment variables for each channel you use.