TG multi-account MCP server
Self-hosted, consent-based access to Telegram accounts and bots for MCP clients
0 stars435 downloads/wk
Reviews
Write oneNobody has reviewed TG multi-account MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
TG multi-account MCP tools (44, 8 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
cancel_scheduled_messagewrite actionCancel one scheduled message by ID.
create_agent_tokenwrite actionCreate a scoped bearer token. The plaintext token is returned only once.
create_draftwrite actionSave a private local message draft without contacting Telegram.
delete_draftwrite actionDelete one local draft.
download_attachmentDownload one image or file attachment up to 10 MB from a message.
download_attachment_chunkRead a base64 chunk from an attachment of any size accepted by Telegram.
edit_own_messageEdit a text message previously sent by the selected personal account.
find_chatsFind dialogs by title or contact name across the latest 500 dialogs.
forward_messagesForward 1–100 existing messages as the selected personal account.
get_capabilitiesDescribe server features, limits and currently configured identities.
get_chat_historyRead history newest first, optionally inside an inclusive YYYY-MM-DD range.
get_chat_infoReturn normalized identity and type metadata for a chat.
get_conversation_snapshotGet chat metadata, recent history and its latest pinned message.
get_folder_messagesMerge messages from chats in a named folder, newest first, with date filters.
get_inbox_contextReturn prioritized unread dialogs with recent message context in one call.
get_messageGet one message by its stable chat and message IDs.
get_message_contextGet a target message with bounded messages immediately before and after it.
get_recent_mentionsList recent messages that mention this account, globally or in one chat.
get_reply_threadReturn a message, its reply ancestry and bounded direct replies.
get_statusReturn aggregate readiness counts for configured accounts and bots.
get_unread_inboxList unread dialogs with mention, reaction and latest-message context.
list_accountsList stable user account IDs and their readiness state.
list_agent_tokensList scoped agent tokens without revealing their token material or hash.
list_attachmentsList attachment-bearing messages by kind and inclusive calendar range.
list_botsList stable bot IDs and their readiness state.
list_chatsList chats for one account. Use next_cursor for further pages.
list_draftsList private local drafts visible to the current agent token.
list_foldersList Telegram chat folders for one account.
list_scheduled_messagesList scheduled messages in one chat.
list_topicsList forum topics for a supergroup.
mark_chat_readMark a chat read through an optional message ID.
poll_updatesPoll new, edited, deleted, read and reaction events after a signed cursor.
react_to_messageSet a standard emoji reaction, or remove the account's reaction with null.
resolve_message_linkResolve a public or private t.me message link to chat, topic and message IDs.
resolve_peerResolve a numeric ID, username, t.me link or fuzzy chat title.
revoke_agent_tokenRevoke one scoped agent bearer token.
schedule_messageSchedule a plain-text message 10 seconds to 365 days in the future.
search_all_messagesSearch every dialog, optionally filtering by date, sender and attachment kind.
search_chat_contentFind links, polls, GIFs, video notes, voice notes or pinned messages.
search_messagesSearch within one chat for one account; the cursor is bound to both.
send_as_botwrite actionSend plain text as the selected bot. Never falls back to a user or another bot.
send_as_userwrite actionSend plain text as the selected personal account. Never falls back to another ID.
send_attachmentwrite actionSend an existing Telegram attachment as the selected personal account.
send_draftwrite actionSend one pending draft; subsequent calls return its stored send receipt.
Public scan report
scanner v0.1.8 · 2026-09-19 · same rubric, same numbers if you re-run it
- Code scan26 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 2 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Install directly
claude mcp add tg-account-mcp -- uvx tg-account-mcp
TG multi-account MCP: common questions
- Is TG multi-account MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the TG multi-account MCP safety report
- How do I install TG multi-account MCP?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does TG multi-account MCP need an API key?
- No secret keys are declared. It reads 1 setting from the environment.
- Is TG multi-account MCP maintained?
- The last commit was 3 days ago (2026-09-18). The latest release is v0.5.2.