Install Telegram Bot

Pick your client, copy the command, done.

Manual setup required. The maintainer's config contains paths only you know — edit the placeholders below before adding it to Claude Code.

Run this once before adding it to Claude Code.

git clone https://github.com/FantomaSkaRus1/telegram-bot-mcp
cd telegram-bot-mcp

Then follow the repository README for any remaining dependency or build steps.

claude mcp add -e "TELEGRAM_BOT_TOKEN=${TELEGRAM_BOT_TOKEN}" telegram-bot -- node /path/to/mcp-telegram/index.js

Replace any placeholder paths in the command with the real path on your machine.

Required:TELEGRAM_BOT_TOKEN+ 2 optional

Environment Variables

Set these before running Telegram Bot.

VariableDescriptionRequired

TELEGRAM_BOT_TOKENBot token from @BotFatherYes

TELEGRAM_DEFAULT_CHAT_IDDefault chat ID to skip chat_id in tool callsNo

TELEGRAM_DEFAULT_THREAD_IDDefault topic/thread ID for forum supergroupsNo

Once configured, Telegram Bot gives your AI agent access to:

send_messageSends a text message to a specified chat.

chat_idtext

send_photoSends a photo to a specified chat.

chat_idphoto

delete_messageDeletes a message from a chat.

chat_idmessage_id

get_chatRetrieves information about a specific chat.

chat_id

After setup, try these prompts with your AI agent:

→Send a message to my Telegram group saying 'Hello from Claude!'

→Get the current information and member count for my Telegram channel.

→Delete the last message sent in the current chat.

→Create a new topic in my Telegram forum group named 'Project Updates'.

Prerequisites & system requirements

An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
Node.js 18+ with npm/npx installed
TELEGRAM_BOT_TOKEN — Bot token from @BotFather

Alternative installation methods

claude mcp add -e TELEGRAM_BOT_TOKEN=your_token telegram -- node /path/to/mcp-telegram/index.js

Save the docs, env vars, and workflow around Telegram Bot in Conare so Claude Code, Codex, and Cursor remember it next time.