Telegram Notifier MCP Server

MCP server for sending notifications via Telegram Bot API

Local serverstdioGo

What is the Telegram Notifier MCP MCP server?

Connect Telegram Notifier MCP to Claude, Cursor or any other MCP client and it stops being a tab you switch to. MCP server for sending notifications via Telegram Bot API. The telegram notifier mcp mcp server is what makes that connection.

What the server does

An MCP server that lets an LLM send messages and files to a user via a Telegram bot, and read incoming messages. No external HTTP or Telegram libraries — just the native fetch API and the official MCP SDK.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • send_message — The send_message tool exposed by this server
  • send_document — The send_document tool exposed by this server
  • send_photo — The send_photo tool exposed by this server
  • send_video — The send_video tool exposed by this server
  • send_audio — The send_audio tool exposed by this server
  • get_updates — Check for new messages sent to the bot. Only returns messages received since the last check

Credentials and setup notes

Configuration is passed through the environment: TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID, YOUR_BOT_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Installation

The server ships on npm as telegram-notifier-mcp, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Where it fits

Plenty of team communication servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Telegram Notifier MCP's toolset — send_message, send_document, send_photo and 3 more — is a fair guide to whether it matches your workflow. It is maintained by adeshatole; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
send_messageThe send_message tool exposed by this server.
send_documentThe send_document tool exposed by this server.
send_photoThe send_photo tool exposed by this server.
send_videoThe send_video tool exposed by this server.
send_audioThe send_audio tool exposed by this server.
get_updatesCheck for new messages sent to the bot. Only returns messages received since the last check.

How to install the Telegram Notifier MCP MCP server

{
  "mcpServers": {
    "telegram-notifier": {
      "command": "npx",
      "args": ["telegram-notifier-mcp"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your-bot-token-here",
        "TELEGRAM_CHAT_ID": "your-chat-id-here"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
TELEGRAM_BOT_TOKENCredential the server authenticates with.Yes
TELEGRAM_CHAT_IDConfiguration value read at startup.Optional
YOUR_BOT_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Telegram Notifier MCP to send message.
  • Use Telegram Notifier MCP to send document.
  • Use Telegram Notifier MCP to send photo.

Frequently asked questions

It connects Telegram Notifier MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (send_message, send_document, send_photo, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Telegram Notifier MCP directly.