aiogram MCP Server
by py2755io.github.Py2755/aiogram-mcpv0.7.1
Middleware exposing aiogram Telegram bots via MCP: messaging, rich media, moderation, keyboards, real-time events, rate limiting, permissions and audit logs.
context tax
queued
security
queued
cold start
queued
freshness
Stale7mo ago
Install aiogram MCP server
Install in Claude Code
claude mcp add aiogram -e BOT_TOKEN='<bot-token>' -- uvx aiogram-mcpInstall in Cursor
{
"mcpServers": {
"aiogram": {
"command": "uvx",
"args": [
"aiogram-mcp"
],
"env": {
"BOT_TOKEN": "<bot-token>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"aiogram": {
"command": "uvx",
"args": [
"aiogram-mcp"
],
"env": {
"BOT_TOKEN": "<bot-token>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"aiogram": {
"type": "stdio",
"command": "uvx",
"args": [
"aiogram-mcp"
],
"env": {
"BOT_TOKEN": "<bot-token>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"aiogram": {
"command": "uvx",
"args": [
"aiogram-mcp"
],
"env": {
"BOT_TOKEN": "<bot-token>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| BOT_TOKEN | yes | yes | Telegram Bot API token from @BotFather |
Freshness
Stale — last maintenance signal 7mo ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-03-16 · 7mo ago · GitHub
Latest release
2026-03-14 · 7mo ago · GitHub · v0.7.0
Package published
no data · npm/PyPI
Registry entry updated
2026-03-14 · 7mo ago · official registry · v0.7.1
FAQ
›How do I install the aiogram MCP server in Claude Code?
Run: claude mcp add aiogram -e BOT_TOKEN='<bot-token>' -- uvx aiogram-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does aiogram require an API key?
Yes. It expects BOT_TOKEN, of which 1 is a secret.
›Can I use aiogram as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is aiogram in the official MCP registry?
Yes, as io.github.Py2755/aiogram-mcp.
Alternatives to aiogram
Other monitoring & observability MCP servers.