de en es ja ko ru zh

telegram-mcp-server

Name: telegram-mcp-server
Author: Steph-ux

by Steph-ux

Overview Schema Related Servers Score Discussions

Python

Remote

telegram-mcp-server

Telegram MCP-сервер на базе Telethon — постоянный клиент, устойчивый к флуду, 9 сгруппированных инструментов.

Никаких API-ключей в коде. Файлы сессий хранятся локально. Работает с пользовательскими аккаунтами (2FA) и ботами.

1. Установка

git clone <this-repo> telegram-mcp-server
cd telegram-mcp-server

python -m venv .venv
# Windows:
.venv\Scripts\activate
# macOS/Linux:
source .venv/bin/activate

pip install -e .

Получите свои учётные данные API

Перейдите на my.telegram.org
Войдите со своим номером телефона
Создайте приложение → получите API ID и API Hash

Разовая авторизация

# User account (with 2FA support)
export TG_API_ID=12345
export TG_API_HASH="your_hash_here"
telegram-mcp-server --auth --phone +33612345678

# Or via MCP tool: tg_session(action="auth", api_id=12345, api_hash="...", phone="+33612345678")

Related MCP server: tdlib-mcp-server

2. Регистрация в вашем MCP-клиенте

Claude Desktop / OpenCode

{
  "mcpServers": {
    "telegram": {
      "command": "telegram-mcp-server",
      "env": {
        "TG_API_ID": "12345",
        "TG_API_HASH": "your_hash_here"
      }
    }
  }
}

Если не в PATH:

{
  "mcpServers": {
    "telegram": {
      "command": "/path/to/.venv/bin/python",
      "args": ["-m", "telegram_mcp_server"],
      "env": {
        "TG_API_ID": "12345",
        "TG_API_HASH": "your_hash_here"
      }
    }
  }
}

Docker

docker build -t telegram-mcp .
docker run -i --rm \
  -v ~/.telegram-mcp/sessions:/root/.telegram-mcp/sessions \
  -e TG_API_ID=12345 \
  -e TG_API_HASH="your_hash" \
  telegram-mcp

3. Каталог инструментов (9 инструментов, 8 действий)

`tg_session` — Управление сессиями

действие	Обязательные аргументы	Описание
`auth`	`api_id`, `api_hash`, `phone` или `bot_token`	Аутентифицироваться (поддерживается 2FA)
`check`	—	Проверить статус входа
`logout`	—	Удалить сессию

`tg_message` — Отправка, пересылка, удаление, ответ

действие	Обязательные аргументы	Описание
`send`	`target`, `text`	Отправить сообщение
`forward`	`target`, `message_id`, `to_target`	Переслать сообщение
`delete`	`target`, `message_id`	Удалить сообщение
`reply`	`target`, `message_id`, `text`	Ответить на сообщение

`tg_chat` — Операции с чатом

действие	Обязательные аргументы	Описание
`list`	—	Показать недавние чаты
`info`	`target`	Получить информацию о чате
`members`	`target`	Перечислить участников чата
`leave`	`target`	Покинуть чат

`tg_search` — Поиск

действие	Обязательные аргументы	Описание
`messages`	`query`	Искать сообщения (опционально в `target`)
`users`	`query`	Искать контакты/пользователей
`channels`	`query`	Искать каналы

`tg_history` — История чата

действие	Обязательные аргументы	Описание
`messages`	`target`	Получить историю сообщений
`media`	`target`	Получить историю только с медиа
`files`	`target`	Получить историю только с файлами

`tg_user` — Операции с пользователем

действие	Обязательные аргументы	Описание
`me`	—	Получить информацию о себе
`info`	`target`	Получить информацию о пользователе
`block`	`target`	Заблокировать пользователя
`unblock`	`target`	Разблокировать пользователя

`tg_media` — Отправка медиа

действие	Обязательные аргументы	Описание
`send_photo`	`target`, `file_path`	Отправить фото
`send_video`	`target`, `file_path`	Отправить видео
`send_file`	`target`, `file_path`	Отправить документ
`send_voice`	`target`, `file_path`	Отправить голосовое сообщение

`tg_channel` — Управление каналом

действие	Обязательные аргументы	Описание
`create`	`title`	Создать супергруппу/канал
`join`	`target`	Вступить в канал
`leave`	`target`	Покинуть канал
`info`	`target`	Получить информацию о канале

`tg_draft` — Черновики сообщений

действие	Обязательные аргументы	Описание
`save`	`target`, `text`	Сохранить черновик
`list`	—	Показать все черновики
`delete`	`target`	Удалить черновик

4. Переменные окружения

Переменная	По умолчанию	Описание
`TG_API_ID`	`0`	Telegram API ID (с my.telegram.org)
`TG_API_HASH`	`""`	Telegram API Hash
`TG_SESSION_DIR`	`~/.telegram-mcp/sessions`	Расположение файлов сессий

5. Безопасность

Ограничитель частоты запросов: действия отправки — не более 5 в минуту; действия чтения — без ограничений.
Автоповтор при FloodWaitError: выжидает необходимое время (не более 5 минут).
Файлы сессий: только локально, никогда не попадают в git.
Поддержка 2FA: полная поддержка аккаунтов с двухфакторной аутентификацией.

6. MCP-ресурсы

tg://version — Версия сервера
tg://session/status — Статус авторизации

Лицензия

MIT

This server cannot be installed

license - not found

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

Telegram MCP Server
Communication Social Media
shaxzodrashid
F
license
A
quality
B
maintenance
Enables AI agents to interact with Telegram via MTProto, supporting high-performance communication and seamless integration.
Updated a month ago (2026-07-23 20:34 UTC)
1
tdlib-mcp-server
Communication Search
Crocodile-beep
F
license
Not graded
quality
C
maintenance
Connects AI agents to Telegram via the official TDLib library, enabling tools like getting user info, listing dialogs, and searching messages.
Updated 2 months ago (2026-06-08 16:35 UTC)
telegram-mcp
Communication
chenzhaoxuan0
A
license
Not graded
quality
C
maintenance
Enables interaction with Telegram Bot API for sending messages, photos, editing messages, answering callbacks, and fetching updates.
Updated 2 months ago (2026-06-18 07:53 UTC)
MIT
Telegram Bot MCP Server
Communication App Automation
mattleads
A
license
Not graded
quality
B
maintenance
Enables sending Telegram messages, photos, and documents, and retrieving bot information through the Telegram Bot API.
Updated 4 months ago (2026-04-08 19:58 UTC)
58
1
MIT

View all related MCP servers

Related MCP Connectors

fast-mcp-telegram
Multi-tenant Telegram gateway for AI agents — HTTP+stdio, 8 tools, MTProto User API
telegram-mcp
Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.
tgden — Telegram catalog & search
Search 1.2M+ Telegram channels, 245k+ chats, 160k+ bots — no account, no key, no install.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Steph-ux/telegram-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

telegram-mcp-server

1. Установка

Получите свои учётные данные API

Разовая авторизация

2. Регистрация в вашем MCP-клиенте

Claude Desktop / OpenCode

Docker

3. Каталог инструментов (9 инструментов, 8 действий)

tg_session — Управление сессиями

tg_message — Отправка, пересылка, удаление, ответ

tg_chat — Операции с чатом

tg_search — Поиск

tg_history — История чата

tg_user — Операции с пользователем

tg_media — Отправка медиа

tg_channel — Управление каналом

tg_draft — Черновики сообщений

4. Переменные окружения

5. Безопасность

6. MCP-ресурсы

Лицензия

Maintenance

Resources

Looking for Admin?

Related MCP Servers