iflow-mcp_muhammad18557-telegram-mcp

# Telegram MCP Server This is a Model Context Protocol (MCP) server for Telegram. With this you can search your personal Telegram messages, search your contacts, and send messages to either individuals or groups.  It connects to your **personal Telegram account** directly via the Telegram API (using the [Telethon](https://github.com/LonamiWebs/Telethon) library). All your messages are stored locally in a SQLite database and only sent to an LLM (such as Claude) when the agent accesses them through tools (which you control). ## Installation ### Prerequisites - Python 3.6+ - Anthropic Claude Desktop app (or Cursor) ### Steps 1. **Clone this repository** ```bash git clone https://github.com/Muhammad18557/telegram-mcp.git cd telegram-mcp ``` Create a Python virtual environment and activate it: ```bash python3 -m venv myenv source myenv/bin/activate ``` Install dependencies: ```bash pip install -r requirements.txt ``` This is the environment that can be used both for running the **Telegram bridge** and the **MCP server**. 2. **Get your Telegram API credentials** - Go to https://my.telegram.org/auth - Log in and go to "API development tools" - Create a new application - Note your API ID and API hash 3. **Run the Telegram bridge** Navigate to the telegram-bridge directory: ```bash cd telegram-bridge ``` Set up your API credentials as environment variables either by exporting them: ```bash export TELEGRAM_API_ID=your_api_id export TELEGRAM_API_HASH=your_api_hash ``` Or by creating a `.env` file based on the provided `.env.example`: ```bash cp .env.example .env nano .env # or use your preferred text editor ``` Then update the values in the `.env` file: ``` TELEGRAM_API_ID=your_api_id TELEGRAM_API_HASH=your_api_hash ``` Run the Python application: ```bash python main.py ``` The fi…