# Notify MCP Server

An MCP server that carries messages from the agent to Telegram, DingTalk, Lark, Feishu, Bark, Ntfy, PushPlus, WeChat Work and Home Assistant.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 28
- Author: aahl
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aahl/mcp-notify
- Updated: 2026-03-26
- HTML: https://affpapa.org/en/nevibecode/mcp/notify-mcp-server

## What it does

The agent gets a set of tools that push text, images, files and links out of the session. Telegram, DingTalk, Lark, Feishu, Bark, Ntfy, PushPlus and Home Assistant each have their own entry points, and WeChat Work comes in two flavours: a group bot and a company app account.

Coverage differs by channel. Telegram offers five tools for text, photo, video, audio and files. The WeChat Work app account adds voice messages and document delivery; its group bot stops at text, images and link cards. A separate `text_to_sound` tool returns an mp3 link for whatever string you hand it.

Startup is one command with `uvx mcp-notify`, or Docker compose listening on port `8809`, or Smithery, which asks for OAuth or a Smithery key. Credentials are per channel, so line up the bot token or device key first — `TELEGRAM_BOT_TOKEN`, `DINGTALK_BOT_KEY`, `BARK_DEVICE_KEY` — otherwise there is nothing to authenticate with. Several keys may also be supplied inside the prompt instead.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `WEWORK_BOT_KEY`, `WEWORK_APP_CORPID`, `WEWORK_APP_SECRET`, `WEWORK_APP_AGENTID`, `WEWORK_APP_TOUSER`, `DINGTALK_BOT_KEY`, `LARK_BOT_KEY`, `FEISHU_BOT_KEY`, `TELEGRAM_DEFAULT_CHAT`, `TELEGRAM_BOT_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-notify -e WEWORK_BOT_KEY=<WEWORK_BOT_KEY> -e WEWORK_APP_SECRET=<WEWORK_APP_SECRET> -e DINGTALK_BOT_KEY=<DINGTALK_BOT_KEY> -e LARK_BOT_KEY=<LARK_BOT_KEY> -e FEISHU_BOT_KEY=<FEISHU_BOT_KEY> -e TELEGRAM_BOT_TOKEN=<TELEGRAM_BOT_TOKEN> -e PUSH_PLUS_TOKEN=<PUSH_PLUS_TOKEN> -- uvx mcp-notify
```
Replace <…> with your own values. 7 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-notify <command>

### Codex

**Platform CLI**
```bash
codex mcp add notify-mcp-server --env WEWORK_BOT_KEY=<WEWORK_BOT_KEY> --env WEWORK_APP_CORPID=<WEWORK_APP_CORPID> --env WEWORK_APP_SECRET=<WEWORK_APP_SECRET> --env WEWORK_APP_AGENTID=<WEWORK_APP_AGENTID> --env WEWORK_APP_TOUSER=<WEWORK_APP_TOUSER> -- uvx mcp-notify
```
Replace <…> with your own values. 7 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-notify <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "notify-mcp-server": {
            "command": "uvx",
            "args": [
                "mcp-notify"
            ],
            "env": {
                "WEWORK_BOT_KEY": "<WEWORK_BOT_KEY>",
                "WEWORK_APP_CORPID": "<WEWORK_APP_CORPID>",
                "WEWORK_APP_SECRET": "<WEWORK_APP_SECRET>",
                "WEWORK_APP_AGENTID": "<WEWORK_APP_AGENTID>",
                "WEWORK_APP_TOUSER": "<WEWORK_APP_TOUSER>"
            }
        }
    }
}
```
Replace <…> with your own values. 7 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-notify <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "notify-mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mcp-notify"
            ],
            "env": {
                "WEWORK_BOT_KEY": "<WEWORK_BOT_KEY>",
                "WEWORK_APP_CORPID": "<WEWORK_APP_CORPID>",
                "WEWORK_APP_SECRET": "<WEWORK_APP_SECRET>",
                "WEWORK_APP_AGENTID": "<WEWORK_APP_AGENTID>",
                "WEWORK_APP_TOUSER": "<WEWORK_APP_TOUSER>"
            }
        }
    }
}
```
Replace <…> with your own values. 7 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-notify <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e WEWORK_BOT_KEY=<WEWORK_BOT_KEY> -e WEWORK_APP_CORPID=<WEWORK_APP_CORPID> -e WEWORK_APP_SECRET=<WEWORK_APP_SECRET> -e WEWORK_APP_AGENTID=<WEWORK_APP_AGENTID> -e WEWORK_APP_TOUSER=<WEWORK_APP_TOUSER> notify-mcp-server uvx mcp-notify
```
Replace <…> with your own values. 7 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-notify <command>

## When to use it
- push a build report into a Telegram chat
- drop a screenshot into a WeChat Work group
- post the same link to DingTalk and Lark
- get a phone push through Bark or Ntfy
- turn a line of text into an mp3 link

## Example prompts
- Send “deploy finished” to the release Telegram chat with `tg_send_message`.
- Post `build.png` to the WeChat Work group bot.
- Convert this paragraph to an mp3 link with `text_to_sound`.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
