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

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install better-tg-cli
  2. Said no? Turn it on later:
    hermes plugins enable better-tg-cli
  3. 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
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in chat apps & voice

All chat apps & voice plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins