✨ From vibe coding to vibe deployment. UBOS MCP turns ideas into infra with one message.

Learn more

telegram-mcp

Requirements

  • Python Project Manager, UV
  • MCP Client

Usage

  1. install dependencies
pip3 install uv
uv venv
source .venv/bin/activate
uv sync
  1. edit .env file with your telegram api id and hash (My Telegram), don’t share with others.

  2. start the http-server

uv run http-server/http-server.py

  1. install the MCP Server

uv run mcp install mcp-server/mcp-server.py

Available Functions

The MCP Server provides the following functions:

  • get_unread_entities: Get entities which have unread messages in them
  • get_unread_messages(id): Get all unread messages from a given entity id
  • get_messages(id, count): Get messages limited by a count from an entity
  • get_entities: Get all entities in the current session
  • get_entity_by_id(id): Get an entity from the current session
  • send_message(entity_id, content, reply_to_message_id): Send a message to an entity with optional markup and reply

Common Issues & How to Fix

  • Claude can’t run MCP server >> Install uv with brew : brew install uv
  • Can’t create new app in Telegram >> Disconnect VPN and retry

License

MIT

Featured Templates

View More

Start your free trial

Build your solution today. No credit card required.

Sign In

Register

Reset Password

Please enter your username or email address, you will receive a link to create a new password via email.