Is Telegram Notify free?

Yes, Telegram Notify is free to use.

How do I install Telegram Notify?

Telegram Notify is a local plugin. Install it using npm package: @parthj/telegram-notify-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Telegram Notify need?

Telegram Notify requires the following credentials or environment variables: TELEGRAM_BOT_TOKEN. You can find setup instructions on the server detail page.

What AI apps work with Telegram Notify?

Telegram Notify uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Telegram Notify MCP Server

by ParthJadhav

CommunicationLow Risk10.0Local

Free

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

About

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

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (2 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

4 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Telegram Bot API token from BotFatherRequired

Environment variable: TELEGRAM_BOT_TOKEN

How to Install

Add this to your MCP configuration file:

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

Documentation

View on GitHub

From the project's GitHub README.

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

Reviews

No reviews yet

Be the first to review this server!

More Communication MCP Servers

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

Telegram Notify MCP Server

About

Security Report

Permissions Required

Findings (1)

What You'll Need

How to Install

Documentation

Telegram Notify MCP

Quick Start

1. Create a Telegram Bot

2. Start a chat with your bot

3. Add to your MCP client

Claude Code

Claude Desktop / Cursor / Windsurf

Configuration

Tools

`send_message`

`send_photo`

`send_document`

How It Works

Development

License

Reviews

No reviews yet

More Communication MCP Servers

Toleno

mcp-creator-python

MarkItDown

mcp-creator-typescript

FinAgent

Google Workspace MCP