aiogram-mcp
by py2755communityv0.7.1
1
aiogram-mcp connects Telegram bots to AI agents via the Model Context Protocol, enabling real-time interactions without rewriting existing handlers.
From the registry: MCP server for aiogram Telegram bots — 30 tools, 7 resources, 3 prompts, event streaming
Install & configure
Prerequisites
- requiredInstall aiogram-mcp from PyPIPython 3.10+ and aiogram 3.20+.
https://pypi.org/project/aiogram-mcp/$ pip install aiogram-mcp - requiredTelegram bot tokenCreate a Telegram bot via @BotFather to get a bot token.https://core.telegram.org/bots
- requiredUser-written host scriptaiogram-mcp is a library that you import into your own aiogram bot entry point (e.g., bot.py) which spawns the MCP server alongside your bot.
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `aiogram-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install aiogram-mcp from PyPI** — Python 3.10+ and aiogram 3.20+. Run: `pip install aiogram-mcp` (https://pypi.org/project/aiogram-mcp/)
- **Telegram bot token** — Create a Telegram bot via @BotFather to get a bot token. (https://core.telegram.org/bots)
- **User-written host script** — aiogram-mcp is a library that you import into your own aiogram bot entry point (e.g., bot.py) which spawns the MCP server alongside your bot.
Canonical MCP server config (stdio transport):
- command: `python`
- args: ["path/to/your/bot.py"]
- required environment variables:
- `BOT_TOKEN`: Telegram Bot API token from BotFather. (example: `<bot_token>`)
Note: Not a standalone MCP server — you embed AiogramMCP inside your own aiogram bot script and run that script as the stdio command.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Not a standalone MCP server — you embed AiogramMCP inside your own aiogram bot script and run that script as the stdio command.
Tools (30)
send_message
Send text with HTML/Markdown formatting
send_photo
Send a photo by URL with optional caption
forward_message
Forward a message between chats
delete_message
Delete a message
pin_message
Pin a message in a chat
send_interactive_message
Send a message with inline keyboard buttons (callback or URL)
edit_message
Edit text and/or keyboard of an existing message
answer_callback_query
Respond to a button press with a toast or alert
get_bot_info
Get bot metadata (username, capabilities)
get_chat_member_info
Get a user's role and profile in a chat
get_user_profile_photos
Get a user's profile photos
get_chat_info
Get chat metadata (title, type, description)
get_chat_members_count
Get number of members in a chat
ban_user
Ban a user (permanent or temporary)
Environment variables
BOT_TOKENrequiredToken for the Telegram botPrerequisites
- • Python 3.10+
Packages
aiogram-mcp
pypiv0.7.1transport: stdio
Details
- Language
- Python
- License
- MIT
- Released
- Mar 14, 2026
- Last commit
- Mar 16, 2026
- Registry name
- io.github.Py2755/aiogram-mcp
Categories
Related Servers
Reddit Mcp Buddy
Reddit browser for AI assistants. Browse posts, search content, analyze users. No API keys needed.
765
Xactions
Twitter X automation MCP - post schedule analytics engagement social media
416
Mcp Whatsapp Cloud
MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API
265