Aiogram MCP

Connect your Telegram bot to AI agents via the Model Context Protocol. aiogram-mcp turns any aiogram bot into an MCP server. AI clients like Claude Desktop can then send messages, read chat history, build interactive menus, and react to events in real time - all through your existing bot, without rewriting a single handler. It runs locally over stdio via the published package.

People connecting communication tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-03-16 · ★ 3 · #78 OF 99 MAINTAINED COMMUNICATION · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Aiogram MCP

before you install - you'll need

BOT_TOKEN

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add py2755-aiogram-mcp -- uvx aiogram-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "py2755-aiogram-mcp": {
      "command": "uvx",
      "args": [
        "aiogram-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package aiogram-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.Py2755 is GitHub-verified and matches the repo owner

03 · What Aiogram MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.7.1 · 2026-03-14

Added · Dockerfile for containerized deployment and Glama listing · server.json for MCP Registry listing · glama.json for Glama server verification · MCP Registry badge in README · See CHANGELOG.md for full history.

v0.7.0 · 2026-03-14

Added · Token bucket rate limiter - limits outgoing Telegram API calls to configurable requests/sec · Permission levels (read, messaging, moderation, admin) - control which tools AI agents can access · Audit log with…

04 · Who maintains Aiogram MCP

aiogram-mcp is maintained by py2755. It's the only MCP server we track from this author; the repo dates to Mar 2026.

05 · Facts

repository: github.com/py2755/aiogram-mcp
category: communication - ranked #78 of 99 actively-maintained communication servers as of 2026-08-25.
registry: io.github.Py2755/aiogram-mcp (active, first published 2026-03-14)
packages: pypi:aiogram-mcp

06 · Aiogram MCP FAQ

What is Aiogram MCP?

Is Aiogram MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-03-16. We re-verify nightly.

How do I install Aiogram MCP?

Run `uvx aiogram-mcp`. The README documents one environment variable (BOT_TOKEN) to set first. You can also paste the ready-made client config above.

Does Aiogram MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Aiogram MCP

Alternatives to Aiogram MCP

Maintained communication servers if Aiogram MCP isn't the fit.

Pairs well with

Servers that cover what Aiogram MCP doesn't - only shown when the pairing reason fits the companion.

More communication MCP servers · Mup · Runframe MCP Server · Cursor History · Threadline MCP · Samihalawa Whatsapp Go MCP

More Python MCP servers · Godot Lens · build123d MCP · Ouroboros · Oh My Wind · TAR Engine · see all