Advertise
MCP.so
Sign In

Telegram MCP Server

@wolderufael

Repository

Basic information

Category

Communication

Transports

stdio

Author

wolderufael

About Telegram MCP Server

No overview available yet

#telegram#mcp#integration#server

Telegram MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "telegram-mcp-server-wolderufael": {
      "command": "uv",
      "args": [
        "venv",
        ".venv",
        "#",
        "Create",
        "a",
        "virtual",
        "environment"
      ]
    }
  }
}

Telegram MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Telegram MCP Server?

A Telegram integration server that provides tools for managing contacts, sending messages, and retrieving channel information through the MCP (Multi-Client Protocol). It is designed for users who want to automate Telegram interactions using a local MCP client.

How to use Telegram MCP Server?

Install Python 3.8+ and Node.js 14+. Clone the repository, create a virtual environment with uv venv, activate it, and run uv pip install. Create a .env file with your Telegram API credentials (TG_API_ID, TG_API_HASH, phone). Integrate with Cursor or Claude Desktop by placing the provided JSON configuration in the appropriate config file, substituting the paths from which uv and pwd. Once configured, you can call tools like get_contacts(), send_message_by_identifier(), get_chat_history(), and get_channel_posts().

Key features of Telegram MCP Server

  • Contact management: list, search, and view last interactions
  • Send messages to contacts by name or phone number
  • Retrieve chat history with date range filtering
  • Get posts from channels with optional date filtering
  • Search channels and view channel information
  • Comprehensive error handling for invalid credentials, network issues, and rate limiting

Use cases of Telegram MCP Server

  • Automate sending messages to multiple contacts
  • Monitor and archive recent conversations
  • Fetch and analyze posts from Telegram channels
  • Retrieve interaction history for customer support or personal records

Frequently asked questions

1

What prerequisites are needed to run Telegram MCP Server?

Python 3.8 or higher, Node.js 14 or higher, a Telegram account, and Telegram API credentials (api_id and api_hash).

2

How do I obtain Telegram API credentials?

The README states you need api_id and api_hash but does not detail how to get them. You must obtain them from Telegram’s developer platform.

3

Is there built‑in rate limiting protection?

Yes, the server includes error handling for rate limiting, along with invalid credentials, network issues, invalid parameters, and permission errors.

4

What are the available tools?

`get_contacts()`, `send_message_by_identifier(identifier, message)`, `get_last_interaction(identifier)`, `get_chat_history(identifier, start_date, end_date, limit)`, and `get_channel_posts(channel_name, start_date, end_date, limit)`.

5

What libraries does this server depend on?

It uses the Telethon library for Telegram API integration and FastMCP for the server framework.

Comments

More Communication MCP servers

MailTester Ninja

Unlimited & Limited

MailTester Ninja checks email addresses in real time by talking to the recipient's mail server, without sending a message, and keeps nothing afterwards. Agents can use it to clean a list, validate a signup, or find a con

Pidgeon

Pidgeon

Email inboxes for AI agents. Give an agent its own address in one call; it sends, receives and replies in threads, waits for a sign-up code and gets it back already extracted, and hands a conversation to a person when it

Atomic Mail Agentic

Atomic-Mail

Let your agents read, send and react to email autonomously, without human involvement

255

B2B Creators

Social Tree Global

Agencies and GTM teams use HeyReach and Instantly to run LinkedIn outbound from personal sender profiles — but those profiles sit empty and prospects don't accept. B2B Creators is the content layer that keeps every sende

SomaCheck Vibecheck

Sensie-agents

Body language for AI agents, on your terms. A consented three-second phone gesture gives your agent an Aligned or Unaligned signal with confidence. You remain the authority.

1
Advertise