MCP Container

mcp-telegram

MCP Server for Telegram

GitHubWebsiteDocs

GitHub Stars

127

User Rating

Not Rated

Favorites

0

Views

607

Forks

14

Issues

6

Installation
Difficulty
Intermediate
Estimated Time
10-20 minutes
Requirements
Python 3.10 or higher
uv (install via official guide)

Installation

Installation

Prerequisites

Python: 3.10 or higher
uv: Install via the [official uv guide](https://github.com/astral-sh/uv#installation).

Installation Steps

Install the mcp-telegram CLI tool: 
bash
uv tool install mcp-telegram

Configuration

Configuration

Basic Configuration

Setting Up Credentials

First, authenticate with your Telegram account: 
bash
mcp-telegram login
This command will prompt you for your API ID, API Hash, phone number, verification code, and 2FA password. Your credentials are securely stored in the session file. > WARNING: Keep your API credentials private and never share them publicly.

Examples

Examples

Basic Usage

Here are basic usage examples for the MCP server:

Command Line Usage

bash
mcp-telegram --help # See all commands

Programmatic Usage

python
import requests

def call_mcp_tool(tool_name, params):
    response = requests.post(
        'http://localhost:3000/mcp/call',
        json={
            'tool': tool_name,
            'parameters': params
        }
    )
    return response.json()


Usage example

result = call_mcp_tool('analyze', {
    'input': 'sample data',
    'options': {'format': 'json'}
})

Use Cases

Building a system where AI agents provide automated responses via Telegram.
Developing a chatbot that analyzes user messages and generates appropriate replies.
Creating an application that downloads media files from Telegram for processing.
Developing a tool that searches specific chats in Telegram and provides relevant information.
Author Information
Yeabsira Driba
Yeabsira Driba
GitHub

15

Followers

5

Repositories

0

Gists

0

Total Contributions

Tags
aianthropicanthropic-claudebotclaudecursorllmmcpmodel-context-protocolmodel-context-protocol-servermtprototelegramtelegram-bottelethon
Related MCPs
mcp-client-for-ollama logo
mcp-client-for-ollama
215

The mcp-client-for-ollama is a simple yet powerful Python client designed for interacting with Model Context Protocol (MCP) servers using Ollama. This client enables local large language models (LLMs) to utilize tools effectively. It primarily facilitates communication with APIs, streamlining workflows and enhancing the capabilities of LLMs.

Python
LangBot logo
LangBot
13398

🤩 Easy-to-use global IM bot platform designed for the LLM era / 简单易用的大模型即时通信机器人开发平台 ⚡️ Bots for QQ / QQ频道 / Discord / WeChat（微信）/ Telegram / 飞书 / 钉钉 / Slack 🧩 Integrated with ChatGPT（GPT)、DeepSeek、Dify、n8n、Claude、Google Gemini、xAI、PPIO、Ollama、阿里云百炼、SiliconFlow、Qwen、Moonshot(Kimi K2)、SillyTraven、MCP、WeClone etc. LLM & Agent & RAG

Python
vibetest-use logo
vibetest-use
795

Vibetest MCP - automated QA testing using Browser-Use agents

Python