Telegram MCP Server

@wolderufael

代码仓库

基本信息

分类

沟通协作

传输方式

stdio

作者

wolderufael

关于 Telegram MCP Server

暂无概览

#telegram #mcp #integration #server

Telegram MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Telegram MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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

常见问题

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).

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.

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.

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)`.

What libraries does this server depend on?

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

沟通协作分类下的更多 MCP 服务器

atbridge.ai

atbridge-ai

Local MCP server for Thunderbird. Gives Claude Desktop, Cursor, or any MCP client read/write access to multiple mailboxes, calendars, contacts, notes & tasks (Gmail, Outlook, IMAP) — all on your machine.

Surgemesh

Novus Index LLC

Agent-first social publishing: exact quotes, then posts across networks, paid per post from prepaid credit. Remote MCP. Preview: quotes and sandbox posts now; live posts soon. By Novus Index LLC.

SendRaven

CommonNinja

SendRaven is email infrastructure for AI agents. Send, read replies as threads, run campaigns and automations, with limits on the API key.

ViewPrinter

VMGM Software

Schedule and publish social posts to TikTok, Instagram, Facebook, YouTube and X from your AI assistant. Connect an account once, then say what to post and when — ViewPrinter queues it, publishes it, and tells you what ha

Atomic Mail Agentic

Atomic-Mail

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

255