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

Anyone in the workspace, viewers included, can read the connected account's chats.

Send

Every send is two steps:

  1. telegram(action="queue", chat_id=…, text=…) holds the exact text and sends nothing.
  2. telegram(action="approve", item_id=…) sends it word for word, after you said yes to that text. discard drops 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.