About FantomaSkaRus1/telegram-bot-mcp
FantomaSkaRus1/telegram-bot-mcp is an MCP server published by FantomaSkaRus1 in the Developer Tools category: send messages and notifications to Telegram chats from your workflows. Deliver quick alerts, updates, and status messages to individuals or groups. Add simple messaging wherever you need real-time reach. It has been installed 1 times through Conduid.
Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.
Install
npx telegram-bot-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about FantomaSkaRus1/telegram-bot-mcp
Powered by Claude · Grounded in docs
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
telegram-bot-mcp
Full-featured Telegram Bot API server for MCP (Model Context Protocol). 174 tools covering the entire Bot API — messages, chats, stickers, payments, forums, stories, and more.
Features
- Messages — send (text, photo, video, audio, document, location, poll, dice, sticker, media groups), edit, forward, copy, delete, pin/unpin, reactions
- Chats — info, settings, permissions, invite links, member management, verification
- Bot — commands, profile, settings, description, menu button, admin rights
- Stickers — create/edit/delete sticker sets, upload stickers, custom emoji
- Payments — invoices, star transactions, gifts, refunds
- Forums — create/edit/close/reopen/delete topics
- Stories — post, edit, delete, repost
- Business — business messages, accounts, connections
- Games — send games, set scores, high scores
- Webhooks — set, delete, get info
Quick Start
npm install
Claude Code
claude mcp add -e TELEGRAM_BOT_TOKEN=your_token telegram -- node /path/to/mcp-telegram/index.js
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"telegram": {
"type": "stdio",
"command": "node",
"args": ["/path/to/mcp-telegram/index.js"],
"env": {
"TELEGRAM_BOT_TOKEN": "your_token"
}
}
}
}
Environment Variables
| Variable | Required | Description |
|---|---|---|
TELEGRAM_BOT_TOKEN |
Yes | Bot token from @BotFather |
TELEGRAM_DEFAULT_CHAT_ID |
No | Default chat ID (skip chat_id in tool calls) |
TELEGRAM_DEFAULT_THREAD_ID |
No | Default topic/thread ID for forum supergroups |
Project Structure
index.js # Entry point — registers all tool modules
utils/api.js # Telegram API client, rate limiting, retry logic
tools/
messages/ # send, edit, forward, manage
chat/ # info, settings, invite, members, verify
bot/ # core, commands, profile, settings
stickers.js
payments.js
forum.js
stories.js
business.js
games.js
webhook.js
License
MIT
README mirrored from the source repository 4 months ago. The original is authoritative.