Happy slice of mcp pizzaMCP.pizza

mcp-notify

MCP.Pizza Chef: aahl

Send messages and alerts directly to popular chat apps like Weixin, Telegram, DingTalk, Bark, Lark, and Feishu from your AI assistant. Easily notify your team or yourself with text, images, files, or audio notifications. Works with apps like Cursor and VS Code by adding a simple configuration, requiring only your messaging bot keys or tokens.

Communication
Other

Use This MCP server To

Send a notification message to my Telegram chat Push alerts to my Weixin or DingTalk group Send a photo or file to a chat via Telegram Notify my team through Feishu or Lark group bots Send mobile notifications via Home Assistant Convert text to an audio mp3 link for notifications

README

💬 Notify MCP Server

简体中文 | English

提供消息推送的 MCP (Model Context Protocol) 服务器，支持企业微信、钉钉、Telegram、Bark、Lark、飞书、Home Assistant

安装

方式1: uvx

{
  "mcpServers": {
    "mcp-notify": {
      "command": "uvx",
      "args": ["mcp-notify"],
      "env": {
        "WEWORK_BOT_KEY": "your-wework-bot-key"
      }
    }
  }
}

方式2: Smithery

需要通过OAuth授权或Smithery key

{
  "mcpServers": {
    "mcp-aktools": {
      "url": "https://server.smithery.ai/@aahl/mcp-notify/mcp" # 流式传输HTTP
    }
  }
}

方式3: Docker

mkdir /opt/mcp-notify
cd /opt/mcp-notify
wget https://raw.githubusercontent.com/aahl/mcp-notify/refs/heads/main/docker-compose.yml
docker-compose up -d
{
  "mcpServers": {
    "mcp-notify": {
      "url": "http://0.0.0.0:8809/mcp" # 流式传输HTTP
    }
  }
}

快速开始

  • 在线体验: fastmcp.cloud
  • 在线体验: smithery.ai
  • 添加到 Cursor Install MCP Server
  • 添加到 VS Code Install MCP Server
  • 添加到 Cherry Studio Install MCP Server
  • 添加到 Claude Code, 执行命令: claude mcp add notify -- uvx mcp-notify
  • 添加到 OpenAI CodeX, 执行命令: codex mcp add notify -- uvx mcp-notify

⚙️ 环境变量

企业微信群机器人
  • WEWORK_BOT_KEY: 企业微信群机器人默认key，也可以在提示词指定
企业微信应用号
  • WEWORK_APP_CORPID: 企业微信所属的企业ID
  • WEWORK_APP_SECRET: 企业微信应用的凭证密钥
  • WEWORK_APP_AGENTID: 企业微信应用的ID，默认: 1000002
  • WEWORK_APP_TOUSER: 企业微信默认接收人ID，也可以在提示词指定，默认: @all
  • WEWORK_BASE_URL: 企业微信API反代理地址，用于可信IP，默认: https://qyapi.weixin.qq.com
钉钉群机器人
  • DINGTALK_BOT_KEY: 钉钉群机器人access_token
  • DINGTALK_BASE_URL: 钉钉API地址，默认: https://oapi.dingtalk.com
飞书/Lark群机器人
  • FEISHU_BOT_KEY: 飞书群机器人key，也可以在提示词指定
  • FEISHU_BASE_URL: 飞书API地址，默认: https://open.feishu.cn
  • LARK_BOT_KEY: Lark群机器人key，也可以在提示词指定
  • LARK_BASE_URL: Lark API地址，默认: https://open.larksuite.com
Telegram
  • TELEGRAM_DEFAULT_CHAT: Telegram 默认会话ID，也可以在提示词指定
  • TELEGRAM_BOT_TOKEN: Telegram 机器人令牌
  • TELEGRAM_BASE_URL: Telegram API反代理地址，默认: https://api.telegram.org
Home Assistant
  • HASS_BASE_URL: Home Assistant 地址，默认: http://homeassistant.local:8123
  • HASS_ACCESS_TOKEN: Home Assistant 长效令牌
  • HASS_MOBILE_KEY: Home Assistant 移动设备key (如: mobile_app_your_iphone)，也可在提示词指定
其他
  • BARK_DEVICE_KEY: 默认Bark设备key，也可以在提示词指定
  • BARK_BASE_URL: Bark API地址，默认: https://api.day.app
  • NTFY_DEFAULT_TOPIC: 默认Ntfy订阅主题，也可以在提示词指定
  • NTFY_BASE_URL: Ntfy API地址，默认: https://ntfy.sh
  • PUSH_PLUS_TOKEN: 默认PushPlus令牌，也可以在提示词指定
  • PUSH_PLUS_BASE_URL: PushPlus API地址，默认: http://www.pushplus.plus

🛠️ 可用工具

企业微信群机器人
  • wework_send_text - 发送文本或Markdown消息
  • wework_send_image - 发送图片消息
  • wework_send_news - 发送图文链接消息
企业微信应用号
  • wework_app_send_text - 发送文本或Markdown消息
  • wework_app_send_image - 发送图片消息
  • wework_app_send_video - 发送视频消息
  • wework_app_send_voice - 发送语音消息
  • wework_app_send_file - 发送文件消息
  • wework_app_send_news - 发送图文链接消息
Telegram Bot
  • tg_send_message - 发送文本或Markdown消息
  • tg_send_photo - 发送图片消息
  • tg_send_video - 发送视频消息
  • tg_send_audio - 发送音频消息
  • tg_send_file - 发送文件消息
其他工具
  • ding_send_text - 通过钉钉群机器人发送文本或Markdown消息
  • lark_send_text - 通过飞书/Lark群机器人发送文本或Markdown消息
  • bark_send_notify - 通过Bark发送通知
  • ntfy_send_notify - 通过Ntfy发送通知
  • pushplus_send_msg - 通过PushPlus发送消息
  • ha_send_mobile - 通过Home Assistant发送通知
  • text_to_sound - 将一段文本转成mp3音频链接

🔗 相关连接

mcp-notify FAQ

Can I use this to send notifications to Telegram?
Yes — it supports sending messages, photos, videos, and files to Telegram chats using your bot token.
Can I use this to send messages to Weixin or DingTalk?
Yes — it supports both enterprise Weixin and DingTalk group robots for sending text and markdown messages.
Which apps can I add this to for use?
You can add it to Cursor and VS Code, among others that support MCP servers.
Do I need an API key or account to use this?
Yes — you need bot keys or tokens for each messaging platform you want to send notifications to.
How difficult is it to set up?
Setup is copy-paste-config level — you just add a small config snippet to your app.
Does it support other messaging platforms?
Yes — it also supports Bark, Lark, 飞书 (Feishu), Home Assistant notifications, and others.