Fast Mcp Telegram
by leshchenko1979communityv0.5.0
36
11
Fast MCP Telegram Server provides production-ready integration for AI assistants with capabilities for search, messaging, and direct API access to Telegram.
From the registry: Telegram MCP server with search and messaging capabilities
Install & configure
Prerequisites
- required
- requiredRun auth setupRun the setup command to authenticate and create a session
$ uvx --from fast-mcp-telegram fast-mcp-telegram-setup --api-id=<api-id> --api-hash=<api-hash> --phone-number=<phone>
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `fast-mcp-telegram` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Telegram API credentials** — Obtain api_id and api_hash from my.telegram.org (https://my.telegram.org)
- **Run auth setup** — Run the setup command to authenticate and create a session Run: `uvx --from fast-mcp-telegram fast-mcp-telegram-setup --api-id=<api-id> --api-hash=<api-hash> --phone-number=<phone>`
Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["fast-mcp-telegram"]
- required environment variables:
- `API_ID`: Telegram API ID (example: `<your-telegram-api-id>`)
- `API_HASH`: Telegram API hash (example: `<your-telegram-api-hash>`)
Note: Also supports HTTP transport with bearer token auth.
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: Also supports HTTP transport with bearer token auth.
Tools (8)
search_messages_globally
Search across all chats with multi-term queries and date filtering.
get_messages
Unified message retrieval with multiple modes for searching and browsing.
send_message
Send new messages with support for file attachments and formatting.
edit_message
Edit existing messages while preserving their structure.
find_chats
Find users, groups, and channels with multi-term search and contact discovery.
get_chat_info
Retrieve detailed profile information about chats.
send_message_to_phone
Send messages to phone numbers with auto-contact management.
invoke_mtproto
Access raw MTProto methods for direct Telegram API interaction.
Environment variables
API_IDrequiredYour Telegram API ID for authentication.API_HASHrequiredYour Telegram API hash for authentication.Packages
fast-mcp-telegram
pypiv0.5.0transport: stdio
Details
- Language
- Python
- License
- MIT
- Released
- Sep 17, 2025
- Last commit
- Apr 11, 2026
- Registry name
- io.github.leshchenko1979/fast-mcp-telegram