mcp-telegram

Name: mcp-telegram
Author: beautyfree

communication MCP Server

Telegram MCP server (MTProto). Connect Claude, Cursor, Claude Code, VS Code, Codex, Cline, Windsurf to a real Telegram account — read/search/send messages, moderate channels, manage stories/contacts/folders, transcribe voice, and call any raw MTProto method. Browser-based sign-in. 100+ tools.

bybeautyfree

VerifiedInstall Ready

communicationcommunication

5 views22 stars4 forksv3.0.0MIT

View on GitHub Homepage Docs

Why This Matters

Discovered via github-topic:mcp-server and last synced 3mo ago.

VerifiedInstall Ready

Source: github-topic:mcp-server
Stars: 22
Last synced: 3mo ago
Install: Instructions detected

Install

1. Install the package

npx -y mcp-telegram

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-telegram": {
      "command": "npx",
      "args": [
        "mcp-telegram"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

208

Tools

Resources

Prompts

Standard I/O

Transport

Available Tools (208)

listDialogs

List dialogs. Filters: `unread`, `archived`, `ignorePinned`, `folder`, `limit`.

updateMyUsername

Set or clear own `@username`.

searchMessages

Search inside one dialog (text, type filter, sender, date range).

setProfilePhoto

Upload a new avatar (local path or URL).

forwardMessages

Forward messages between dialogs.

deleteStory

Delete own stories.

searchDialogs

Find dialogs by name/title/username substring.

logout

Drop a local session and revoke it on Telegram.

getMessage

Fetch one or more messages by id.

viewStory

Mark stories viewed.

listMessages

List messages in a dialog.

setBirthday

Set the account birthday.

deleteMessages

Delete by id (optionally revoke for all).

Tool

What it does

unbanUser

Lift restrictions.

getAdminLog

Recent admin events with event-type filter.

togglePreHistoryHidden

Hide history from new members.

transferOwnership

Hand over creator rights (requires 2FA password).

editTopic

Rename, re-icon, close, hide.

setNotifySettings

Update mute, previews, sound, story-mute.

deleteContact

Remove users from contacts.

addRecentSticker

Pin a sticker to recent.

TELEGRAM_API_ID

yes

login

Browser-based sign-in. Adds an account.

listAccounts

List signed-in accounts.

sendMessage

Send text.

sendFile

Send a file (path or URL). Albums via array.

downloadMedia

Save a message's media to disk.

transcribeMessage

Transcribe voice/video (Premium).

openSettings

Open the local settings page (tool surface + read-only).

getMe

Return the profile of the authenticated user.

updateProfile

Change own first/last name and bio.

resolveUsername

Resolve `@username` to a user/channel/chat entity.

listFolders

List custom dialog folders (chat filters).

getMessageReactions

Read reactions.

markAsRead

Mark messages read up to an id.

downloadProfilePhoto

Save a peer's avatar to disk.

getPollResults

Fetch tally.

searchGlobal

Search across every chat.

sendReaction

Set emoji reactions on a message.

votePoll

Cast a vote.

getPeerStories

One peer's stories.

promoteAdmin

Grant admin rights (with rank).

editTitle

Change title (works for channels, supergroups, and basic groups).

leaveChannel

Leave a channel/supergroup.

createInviteLink

New link with optional expiry, usage cap, join-request gate.

saveDraft

Save a draft for a dialog.

createFolder

New folder with include/exclude rules.

getMyBoosts

List your boost slots.

MCP_TELEGRAM_HOME

editMessage

Edit a previously sent message.

setDefaultReaction

Set account-wide default.

banUser

Full ban (optional `untilDate`).

deleteUserHistory

Remove every message by a user.

toggleSignatures

Author signatures on channel posts.

migrateChat

Basic group → supergroup.

createTopic

Create a new topic.

getNotifySettings

Read settings.

addContact

Add a user to contacts.

installStickerSet

Install by short name.

sendMessageToPhone

Send to a phone number, auto-creates a temporary contact.

closePoll

Finalize a poll.

sendStory

Post a story (photo or video).

demoteAdmin

Strip admin rights.

editAbout

Change description.

getChannelInfo

Extended info (about, counts, linked chat, slow-mode).

listInviteLinks

List active or revoked links.

clearDraft

Drop the draft for a dialog.

editFolder

Replace folder rules.

listBlocked

Block list.

applyBoost

Apply slots to a channel.

MCP_TELEGRAM_DOWNLOADS

sendPoll

Send a poll. Supports quiz, multiple-choice, anonymous, close period.

listStories

Feed of contacts' stories.

restrictUser

Apply a custom rights mask.

toggleJoinRequest

Require admin approval to join.

searchContacts

Search contacts + global directory.

TELEGRAM_API_HASH

yes

getStoryViewers

List who viewed your story.

getParticipant

Single participant info.

checkUsername

Check availability.

createChannel

New broadcast channel or supergroup (optional forum mode).

mutePeer

Mute a chat (optional `untilDate`).

invokeMtproto

Call any MTProto method by qualified name (e.g. `messages.SendMessage`, `stories.GetAllStories`). String values for `peer`/`channel`/`user`/`fromPeer`/`toPeer`/`bot`/`chat` are auto-resolved to InputPeer / InputUser.

MCP_TELEGRAM_DISABLE

inviteUser

Add users to a channel/supergroup.

editPhoto

Change avatar (path or URL).

getUserInfo

Extended user info (bio, common chats).

revokeInviteLink

Revoke a specific link.

listDrafts

List all dialog drafts.

deleteFolder

Remove a folder.

getPrivacy

Read a privacy key.

MCP_TELEGRAM_READONLY

kickParticipant

Kick from chat/channel.

updateUsername

Set/clear public `@username`.

listInviteJoiners

List users that joined via a link.

reorderFolders

Set display order.

setPrivacy

Update a privacy key (mode + allow/disallow lists).

getInlineBotResults

Run an inline bot query.

MCP_TELEGRAM_TOOLS

listParticipants

Members with filter (admins/banned/bots/...) and substring search.

setSlowMode

Set slow-mode seconds.

deleteChannel

Permanently delete.

listTopics

List forum topics.

unmutePeer

Unmute.

listContacts

All contacts.

getMyStickers

Installed sticker sets.

LOG_LEVEL

download_media

Save a message's media to disk.

get_me

Return the profile of the authenticated user.

list_folders

List custom dialog folders (chat filters).

get_story_viewers

List who viewed your story.

get_participant

Single participant info.

check_username

Check availability.

create_channel

New broadcast channel or supergroup (optional forum mode).

mute_peer

Mute a chat (optional `untilDate`).

list_accounts

List signed-in accounts.

list_dialogs

List dialogs. Filters: `unread`, `archived`, `ignorePinned`, `folder`, `limit`.

list_messages

List messages in a dialog.

search_global

Search across every chat.

search_dialogs

Find dialogs by name/title/username substring.

send_message

Send text.

transcribe_message

Transcribe voice/video (Premium).

invoke_mtproto

open_settings

Open the local settings page (tool surface + read-only).

update_profile

Change own first/last name and bio.

update_my_username

Set or clear own `@username`.

set_birthday

Set the account birthday.

list_contacts

All contacts.

get_message

Fetch one or more messages by id.

get_message_reactions

Read reactions.

edit_message

Edit a previously sent message.

delete_messages

Delete by id (optionally revoke for all).

send_reaction

Set emoji reactions on a message.

send_message_to_phone

Send to a phone number, auto-creates a temporary contact.

download_profile_photo

Save a peer's avatar to disk.

vote_poll

Cast a vote.

close_poll

Finalize a poll.

get_poll_results

Fetch tally.

set_default_reaction

Set account-wide default.

get_peer_stories

One peer's stories.

send_story

Post a story (photo or video).

delete_story

Delete own stories.

ban_user

Full ban (optional `untilDate`).

search_messages

Search inside one dialog (text, type filter, sender, date range).

send_file

Send a file (path or URL). Albums via array.

set_profile_photo

Upload a new avatar (local path or URL).

resolve_username

Resolve `@username` to a user/channel/chat entity.

mark_as_read

Mark messages read up to an id.

forward_messages

Forward messages between dialogs.

send_poll

Send a poll. Supports quiz, multiple-choice, anonymous, close period.

list_stories

Feed of contacts' stories.

view_story

Mark stories viewed.

restrict_user

Apply a custom rights mask.

kick_participant

Kick from chat/channel.

update_username

Set/clear public `@username`.

toggle_join_request

Require admin approval to join.

list_invite_joiners

List users that joined via a link.

reorder_folders

Set display order.

search_contacts

Search contacts + global directory.

set_privacy

Update a privacy key (mode + allow/disallow lists).

get_inline_bot_results

Run an inline bot query.

unban_user

Lift restrictions.

get_admin_log

Recent admin events with event-type filter.

toggle_pre_history_hidden

Hide history from new members.

transfer_ownership

Hand over creator rights (requires 2FA password).

edit_topic

Rename, re-icon, close, hide.

set_notify_settings

Update mute, previews, sound, story-mute.

delete_contact

Remove users from contacts.

add_recent_sticker

Pin a sticker to recent.

promote_admin

Grant admin rights (with rank).

edit_title

Change title (works for channels, supergroups, and basic groups).

leave_channel

Leave a channel/supergroup.

create_invite_link

New link with optional expiry, usage cap, join-request gate.

save_draft

Save a draft for a dialog.

create_folder

New folder with include/exclude rules.

get_my_boosts

List your boost slots.

TELEGRAM_AGENT_HOME

demote_admin

Strip admin rights.

edit_about

Change description.

get_channel_info

Extended info (about, counts, linked chat, slow-mode).

list_invite_links

List active or revoked links.

clear_draft

Drop the draft for a dialog.

edit_folder

Replace folder rules.

list_blocked

Block list.

apply_boost

Apply slots to a channel.

TELEGRAM_AGENT_DOWNLOADS

invite_user

Add users to a channel/supergroup.

edit_photo

Change avatar (path or URL).

get_user_info

Extended user info (bio, common chats).

revoke_invite_link

Revoke a specific link.

list_drafts

List all dialog drafts.

delete_folder

Remove a folder.

get_privacy

Read a privacy key.

list_participants

Members with filter (admins/banned/bots/...) and substring search.

set_slow_mode

Set slow-mode seconds.

delete_channel

Permanently delete.

list_topics

List forum topics.

unmute_peer

Unmute.

get_my_stickers

Installed sticker sets.

Variable

Required

delete_user_history

Remove every message by a user.

toggle_signatures

Author signatures on channel posts.

migrate_chat

Basic group → supergroup.

create_topic

Create a new topic.

get_notify_settings

Read settings.

add_contact

Add a user to contacts.

install_sticker_set

Install by short name.

Works Well With - Skills

c-slack

Send messages and upload files to Slack channels using the `slack` CLI. Supports direct messages, channel posts, file uploads, and thread replies.

4 starsHas guide

c-telegram

Bidirectional Telegram bridge — talk to Claude from your phone. Built into OpenPaw.

4 starsHas guide

mesh-awareness

Discover agents across local node and mesh peers at runtime — their roles, handles, and how to communicate with or delegate to them.

3 starsHas guide

storytelling-with-data

Apply data visualization and storytelling principles from Storytelling with Data by Cole Nussbaumer Knaflic. Covers choosing effective visuals (line, bar, table, scatterplot), eliminating clutter (Gestalt principles, data-ink ratio), focusing attention (preattentive attributes, strategic color), thinking like a designer (affordances, alignment, white space), and narrative structure (three-act story, horizontal/vertical logic, Big Idea). Trigger on "data visualization", "chart design", "dashboard design", "data storytelling", "presentation chart", "declutter chart", "bar chart", "line chart", "data narrative", "slide deck data", "chart review", "viz critique", "storytelling with data".

2 stars

Works Well With - Agents

Awesome Agent Skills For Empirical Research

🔬 A curated collection of 23,000+ agent skills for empirical research across 8 social science disciplines. | 精选 23,000+ AI Agent 技能库，覆盖8大社会科学学科的实证研究。CoPaper.AI 20分钟完成一篇可复现的规范实证论文，并支持用户上传 Skills。-- Maintained by CoPaper.AI from Stanford REAP.

4385 starslangchain

Auto Empirical Research Skills

4108 starslangchain

AgentNetworkProtocol

AgentNetworkProtocol(ANP) is an open source protocol for agent communication. Our vision is to define how agents connect with each other, building an open, secure, and efficient collaboration network for billions of intelligent agents.

1426 stars