gabrielbbal10/notifyhub-mcp
NotifyHub MCP Server — send notifications via any channel from AI assistants
Image
0
1.0K
gabrielbbal10/notifyhub-mcp repository overview
Short description:
MCP Server for AI agents — send notifications via 14 channels (Email, SMS, Slack, Discord, Telegram, Teams, Twitter/X, LinkedIn, Notion...) with 16 tools.
Repository overview:
<p align="center">
<img src="https://raw.githubusercontent.com/GabrielBBaldez/notify-hub/master/docs/logo.png" alt="NotifyHub" width="150"/>
</p>
# NotifyHub MCP Server
Model Context Protocol (MCP) server that gives AI agents the ability to send notifications via **14 channels** using **16 tools**. Works with Claude Desktop, Claude Code, Cursor, Windsurf, or any MCP-compatible client.
## Quick Start
### Claude Desktop / Claude Code
Add to your MCP config (`claude_desktop_config.json` or `.mcp.json`):
```json
{
"mcpServers": {
"notify-hub": {
"command": "docker",
"args": ["run", "-i", "--rm",
"-e", "NOTIFY_CHANNELS_EMAIL_HOST=smtp.gmail.com",
"-e", "NOTIFY_CHANNELS_EMAIL_PORT=587",
"-e", "[email protected]",
"-e", "NOTIFY_CHANNELS_EMAIL_PASSWORD=your-app-password",
"-e", "[email protected]",
"-e", "NOTIFY_CHANNELS_DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...",
"gabrielbbal10/notifyhub-mcp:0.7.0"
]
}
}
}
Then just ask your AI: "Send an email to [email protected] saying the deploy is complete"
16 MCP Tools
| Tool | Channel |
|---|---|
| send_email | Email (SMTP) |
| send_sms | SMS (Twilio) |
| send_whatsapp | WhatsApp (Twilio) |
| send_slack | Slack (Webhook) |
| send_telegram | Telegram (Bot API) |
| send_discord | Discord (Webhook) |
| send_teams | Microsoft Teams (Webhook) |
| send_google_chat | Google Chat (Webhook) |
| send_push | Firebase Cloud Messaging |
| send_twitter | Twitter/X (API v2) |
| send_linkedin | LinkedIn (REST API) |
| send_notion | Notion (API) |
| send_notification | Any channel (dynamic) |
| send_multi_channel | Multiple channels at once |
| list_channels | List configured channels |
| list_delivery_receipts | View notification history |
What You Can Say to Your AI
- "Send an email to [email protected] saying the deploy is complete"
- "Post a message on Discord #alerts that the server is down"
- "Send an SMS to +5548999999999 with the verification code"
- "Tweet that our v0.7.0 release is live"
- "Create a Notion page with today's standup notes"
- "Send a Slack message to #dev-team about the new feature"
Environment Variables
Configure only the channels you need:
| Variable | Channel |
|---|---|
NOTIFY_CHANNELS_EMAIL_HOST, _PORT, _USERNAME, _PASSWORD, _FROM | |
NOTIFY_CHANNELS_SMS_ACCOUNT_SID, _AUTH_TOKEN, _FROM_NUMBER | SMS |
NOTIFY_CHANNELS_WHATSAPP_ACCOUNT_SID, _AUTH_TOKEN, _FROM_NUMBER | |
NOTIFY_CHANNELS_SLACK_WEBHOOK_URL | Slack |
NOTIFY_CHANNELS_TELEGRAM_BOT_TOKEN | Telegram |
NOTIFY_CHANNELS_DISCORD_WEBHOOK_URL | Discord |
NOTIFY_CHANNELS_TEAMS_WEBHOOK_URL | Teams |
NOTIFY_CHANNELS_GOOGLE_CHAT_WEBHOOK_URL | Google Chat |
NOTIFY_CHANNELS_PUSH_CREDENTIALS_PATH | Firebase Push |
NOTIFY_CHANNELS_TWITTER_API_KEY, _API_SECRET, _ACCESS_TOKEN, _ACCESS_TOKEN_SECRET | Twitter/X |
NOTIFY_CHANNELS_LINKEDIN_ACCESS_TOKEN, _AUTHOR_ID | |
NOTIFY_CHANNELS_NOTION_API_KEY, _DATABASE_ID | Notion |
Links
- 🌐 Landing Page: gabrielbbaldez.github.io/notify-hub
- 📦 GitHub: github.com/GabrielBBaldez/notify-hub
- 🐳 REST API Image: hub.docker.com/r/gabrielbbal10/notifyhub-api
- ☕ Maven Central: central.sonatype.com/namespace/io.github.gabrielbbaldez
Tag summary
Content type
Image
Digest
sha256:1834c41e7…
Size
87 MB
Last updated
6 months ago
docker pull gabrielbbal10/notifyhub-mcp