tdelegram
Installation
SKILL.md
TDelegram
TDelegram speaks to Telegram as the user's own account, not a bot. Everything you read is their real inbox, and everything you write is attributed to them and visible to other people. That single fact shapes every rule below.
Three ways in. If tdelegram MCP tools are already connected to you, use them and
read references/mcp.md; otherwise you will almost always want the CLI:
| Layer | What it is |
|---|---|
tdelegram CLI |
JSON Lines on stdout, diagnostics on stderr. Built to be piped into jq. |
tdelegram Python package |
TelegramClient plus domain modules, for writing code against it. See references/library.md. |
tdelegram mcp server |
The same account and the same gate as typed tools for an MCP client; confirm=true stands in for --yes. See references/mcp.md. |
Check it is installed with tdelegram version. If that fails, TDelegram is not
set up on this machine — follow references/setup.md rather than improvising
with another Telegram library.