Telegram Notify MCP server | MCP Fair

Telegram Notify MCP server | MCP Fair

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @parthj/[email protected]

Credentials from the publisher

TELEGRAM_BOT_TOKEN — Telegram Bot API token from BotFather

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1TELEGRAM_BOT_TOKEN=<secret> claude mcp add io.github.parthjadhav-telegram-notify-mcp -- npx -y @parthj/telegram-notify-mcp@1.0.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.parthjadhav-telegram-notify-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "@parthj/[email protected]"8      ],9      "env": {10        "TELEGRAM_BOT_TOKEN": "<secret>"11      }12    }13  }14}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Server facts

Local

Transport: stdio
Version: 1.0.1
API key

Tools

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "io.github.parthjadhav-telegram-notify-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "@parthj/[email protected]"8      ],9      "env": {10        "TELEGRAM_BOT_TOKEN": "<secret>"11      }12    }13  }14}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

From the publisher

Documentation

Telegram Notify MCP

A dead-simple MCP server with one job: send AI agent progress back to you on Telegram.

That's it. No chat management, no group administration, no inline queries. Just notifications — as text, images, or files.

You kick off an agent, walk away, and get a Telegram message when it's done (or while it's working). Nothing more, nothing less.

Quick Start

1. Create a Telegram Bot

Message @BotFather on Telegram
Send /newbot and follow the prompts
Copy the bot token

2. Start a chat with your bot

Find your bot on Telegram and send /start. This is required so the bot can discover your chat ID.

3. Add to your MCP client

Claude Code

claude mcp add telegram -e TELEGRAM_BOT_TOKEN=your-token -e TELEGRAM_USERNAME=your-username -- npx @parthj/telegram-notify-mcp

Claude Desktop / Cursor / Windsurf

Add to your MCP config file:

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": ["-y", "@parthj/telegram-notify-mcp"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your-bot-token",
        "TELEGRAM_USERNAME": "your-telegram-username"
      }
    }
  }
}

Configuration

Environment Variable	Required	Description
`TELEGRAM_BOT_TOKEN`	Yes	Bot token from @BotFather
`TELEGRAM_USERNAME`	Yes	Your Telegram username (without the @)

Tools

Three tools. That's the entire surface area.

`send_message`

Send a text update to the user.

Parameter	Type	Required	Description
`text`	string	Yes	The message text
`parse_mode`	string	No	`HTML`, `Markdown`, or `MarkdownV2`

`send_photo`

Send an image — a screenshot, a chart, a generated visual.

Parameter	Type	Required	Description
`photo`	string	Yes	URL or absolute file path
`caption`	string	No	Photo caption
`parse_mode`	string	No	Caption formatting mode

`send_document`

Send a file — a report, a log, a build artifact.

Parameter	Type	Required	Description
`document`	string	Yes	URL or absolute file path
`caption`	string	No	Document caption
`parse_mode`	string	No	Caption formatting mode

How It Works

On the first tool call, the server resolves your username to a chat ID via the Telegram Bot API's getUpdates
Sending /start to the bot is required — Telegram bots can only message users who have initiated a conversation
The chat ID is cached for the lifetime of the process

Development

git clone https://github.com/ParthJadhav/telegram-notify-mcp.git
cd telegram-notify-mcp
npm install
npm run build

License

MIT