Install Aiogram MCP

Pick your client, copy the command, done.

claude mcp add -e "BOT_TOKEN=${BOT_TOKEN}" aiogram-mcp -- python path/to/your/bot.py

Required:BOT_TOKEN

Environment Variables

Set these before running Aiogram MCP.

VariableDescriptionRequired

BOT_TOKENThe Telegram Bot API token provided by BotFatherYes

Once configured, Aiogram MCP gives your AI agent access to:

send_messageSend text with HTML/Markdown formatting

chat_idtext

send_photoSend a photo by URL with optional caption

chat_idphoto_urlcaption

forward_messageForward a message between chats

chat_idfrom_chat_idmessage_id

delete_messageDelete a message

chat_idmessage_id

pin_messagePin a message in a chat

chat_idmessage_id

send_interactive_messageSend a message with inline keyboard buttons

chat_idtextbuttons

edit_messageEdit text and/or keyboard of an existing message

chat_idmessage_idtext

answer_callback_queryRespond to a button press with a toast

callback_query_idtext

After setup, try these prompts with your AI agent:

→Send a welcome message to the group chat with ID 123456789.

→Create an interactive menu for users to select their preferred support topic.

→Pin the latest announcement message in the main channel.

→Edit the previous message to update the status of the current task.

Prerequisites & system requirements

An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
Python 3.8+ with pip installed
BOT_TOKEN — The Telegram Bot API token provided by BotFather

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