Allows publishing and managing posts in a Telegram channel via the Bot API, including sending text, photos, videos, albums, documents, voice messages, polls/quizzes, paid content, and editing, deleting, pinning, copying, and reacting to messages.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@telegram-channel-mcp-server Post a message to our Telegram channel announcing the new release."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server (stdio) for publishing and managing posts in a Telegram channel via the Bot API. Lets an agent (Claude Code, Claude Desktop, etc.) post text, photos, videos, albums, documents, voice messages, video notes, polls/quizzes and paid content, and edit/delete/pin posts.
npm install
npm run buildRelated MCP server: Telegram Bot MCP Server
Variable | Required | Description |
| yes | Bot token from @BotFather. The bot must be a channel admin with the "Post messages" permission (and the matching rights for editing/deleting). |
| no | Default channel: |
claude mcp add telegram-channel -e TELEGRAM_BOT_TOKEN=123:ABC -e TELEGRAM_CHAT_ID=-1001234567890 -- node /abs/path/telegram-channel-mcp/dist/index.jsclaude_desktop_config.json){
"mcpServers": {
"telegram-channel": {
"command": "node",
"args": ["/abs/path/telegram-channel-mcp/dist/index.js"],
"env": { "TELEGRAM_BOT_TOKEN": "123:ABC", "TELEGRAM_CHAT_ID": "-1001234567890" }
}
}
}Tool | What it does |
| Text with HTML/MarkdownV2, link preview control, buttons |
| A single media item with caption, spoiler, buttons |
| Album of 2-10 items as one post |
| Paid post for Telegram Stars |
| Poll or quiz / close it and get the results |
| Change text, caption, media, buttons |
| Delete up to 100 posts |
| Pin / unpin |
| Copy or forward a post from another chat |
| React on behalf of the channel |
| Channel info and subscriber count (read-only) |
Media in every tool is given as a string: a public http(s) URL, an absolute path to a local file (the server uploads it), or a Telegram file_id (returned in the send result, so you can reuse a file without uploading it again).
Buttons are an array of rows: [[{ "text": "Website", "url": "https://…", "style": "primary" }], [{ "text": "Copy", "copy_text": "PROMO" }]]. Exactly one of url / callback_data / copy_text; style: primary | success | danger.
Albums and video notes cannot carry buttons - send them in a separate message.
In an album show_caption_above_media applies to all items at once.
Paid content works in channels only, 1-10 000 stars.
Polls in channels are always anonymous.
Limits: text 4096 chars, caption 1024, file 50 MB on upload / 20 MB via URL.
npm run dev # run from sources
npm run smoke -- /path/to/img.png # e2e check against a real channel (creates and deletes test posts)
npx @modelcontextprotocol/inspector node dist/index.jsLayout: src/telegram.ts - API client and media resolution, src/schemas.ts - shared zod schemas,
src/format.ts - response formatting, src/tools/* - tools grouped by domain, src/index.ts - entry point.
This server cannot be deployed
Run a Telegram channel from your AI agent. Posts go out through your own bot, not your account.
Telegram channels you administer: analytics, content plans, scheduled publishing. No userbot
Publish, schedule, and manage social media posts across major platforms via the Postproxy API.
Live Telegram data: trending topics, channel profiles & metrics, post history incl. edits/deletions.
