Telegram
Last updated 16 November 2026
The telegram tool works with your workspace's own Telegram account: your groups and the people you already talk to. It is not for outreach: no campaigns and no messages to strangers. It is a tool of the local client, started with HEYLEAD_TOOLS=all; the hosted MCP server at heylead.dev/mcp does not offer it.
Connect
telegram(action="connect") returns a sign-in link (a QR code or your phone number). It needs an editor role. On Free, a Telegram account counts as your one connected account; a second account of another kind needs Pro.
Read
telegram(action="chats"): your 1:1 chats and groups, with unread counts.telegram(action="read", chat_id=…): the latest messages, up to 100 per call. Attachments show as present; their content is not read.
Anyone in the workspace, viewers included, can read the connected account's chats.
Send
Every send is two steps:
telegram(action="queue", chat_id=…, text=…)holds the exact text and sends nothing.telegram(action="approve", item_id=…)sends it word for word, after you said yes to that text.discarddrops it.
At most one message every 20 seconds, up to 4,096 characters. telegram(action="outbox") lists held, sent and failed messages. Approving and discarding need an editor role.