Better-TG-CLI
From its catalog listing
Telegram on your own account (not a bot) through a local MCP server and a skill: read and search chats, threads, comments and forum topics, press bot buttons, and send, edit, react or forward only after you approve each action. Portable Agent Plugins v1 package (mcp.json + skills/).
Good to know before installing
Runs the `better-tg-cli@0.39.6` npm package locally over stdio through `npx` (Node.js 20+; no runtime dependencies, downloaded from npm on first start), in the plugin's data folder. Network: Telegram's own servers over MTProto; the project's login service (better-tg-cli.com, API at tg-cli-broker.login-c2d.workers.dev) only while you log in with a login key; a once-a-day version check to registry.npmjs.org only when the CLI runs in your own terminal (never under Hermes; off with TG_NO_UPDATE_CHECK=1). No telemetry. Login happens once in your own terminal (`npx -y better-tg-cli onboard`), and the skill may install the CLI globally from npm, brew or scoop after asking you; the session and the app's API hash are the CLI's own, stored in its own items in the macOS Keychain, the Linux Secret Service, Windows DPAPI, 1Password (when configured) or a 0600 file in ~/.config/tg, and anyone holding that session controls the Telegram account. It never reads Hermes' secrets or another tool's login. mcp.json forwards only DBUS_SESSION_BUS_ADDRESS, XDG_RUNTIME_DIR and the CLI's own TG_PROFILE, TG_READ_ONLY, TG_LOG_LEVEL, TG_FLOOD_WAIT_MAX, TG_TRANSPORT, TG_NO_UPDATE_CHECK; no credential. Tools that change state (send, edit, delete for everyone, react, forward, pin, leave a chat, and saving media or exports to a folder the agent names) go through MCP elicitation, one Allow Once / Deny per action; unattended runs time out and nothing is sent. Writing without asking can only be switched on in a terminal or OS dialog, never over MCP; on Linux without a secret store that setting is a plain 0600 file the agent's terminal could edit. Login, logout and account transfer are not exposed. Every write is logged locally. The server runs its bundled CLI as a child process per tool call. The tool set comes from the pinned npm version.
From its catalog listing.
How to install
- Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
hermes plugins install better-tg-cli - Said no? Turn it on later:
hermes plugins enable better-tg-cli - Restart Hermes so it loads the plugin.
Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).
- Category
- Chat apps & voice
- Maintained by
- TheVilfer (Community)
- Needs
- No API keys declared
- Needs Hermes
- 0.22.3 or newer
- Version
- 0.39.6
- In the catalog
- 2026-11-09
- GitHub stars
- 7
Using the Hermes desktop app? See where plugins live

Full setup & settings ↗Source code ↗
More in chat apps & voice
New Hermes Agent updates every day on X. Follow @HermesWatcher