# Telegram Notify Mcp

> Send Telegram notifications from AI agents — text, photos, and documents.

- **Type:** MCP server
- **Install:** `agentstack add mcp-parthjadhav-telegram-notify-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ParthJadhav](https://agentstack.voostack.com/s/parthjadhav)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 1.0.1
- **License:** MIT
- **Upstream author:** [ParthJadhav](https://github.com/ParthJadhav)
- **Source:** https://github.com/ParthJadhav/telegram-notify-mcp

## Install

```sh
agentstack add mcp-parthjadhav-telegram-notify-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

[](https://bloom.parthjadhav.com)

# Telegram Notify MCP

[](https://www.npmjs.com/package/@parthj/telegram-notify-mcp)
[](https://opensource.org/licenses/MIT)

A dead-simple [MCP](https://modelcontextprotocol.io) 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

1. Message [@BotFather](https://t.me/BotFather) on Telegram
2. Send `/newbot` and follow the prompts
3. 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

```bash
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:

```json
{
  "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](https://t.me/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

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

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ParthJadhav](https://github.com/ParthJadhav)
- **Source:** [ParthJadhav/telegram-notify-mcp](https://github.com/ParthJadhav/telegram-notify-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v1.0.1 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **1.0.1** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-parthjadhav-telegram-notify-mcp
- Seller: https://agentstack.voostack.com/s/parthjadhav
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.