tg — Telegram access for AI agents

    1

    Read, search and automate Telegram with a small local runtime and the full Telethon API.

    Free

    1 useSecurity scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    About this skill

    A small, authenticated Telegram runtime for agents and humans. Read and search chats, work with media, and run ordinary Python against Telethon's client methods and raw Telegram API.

    This download contains the agent skill, setup documentation and original MIT license. Install the separate tg-harness runtime and complete Telegram login locally before use. Requires Python 3.12+ and macOS or Linux.

    The runtime is not a sandbox: scripts have the permissions of the selected Telegram account, including sending, editing and deleting. The skill instructs the agent to check the user's request and target before externally visible actions. Credentials and session files remain on the user's machine and are not included in this download.

    Source: https://github.com/speech115/tg License: MIT; original license included. This listing does not replace the open-source license.

    Not a sandbox or a permission-enforcement layer. Requires local setup and Telegram login. Session locking does not coordinate rate limits across separate sessions. Respect Telegram FloodWait restrictions.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    1 use

    Times used to date

    Free forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 1 month ago

    • Free with an Agensi account

    Requires

    Telegram
    macOS
    Python

    Permissions

    Terminal / Shell
    Read Files
    Write Files
    Network Access
    Environment Variables

    Allowed Hosts

    api.telegram.org

    Uses the locally authenticated Telegram account and can read, send, edit, delete, download and perform raw Telegram API operations. Scripts run with local user permissions. Credentials, configuration and Telethon session files stay local. Environment variables are optional configuration inputs.

    Listed1 month ago

    What's inside

    Frequently Asked Questions

    This skill allows AI agents to interact with Telegram via the Telethon API, enabling them to read message history, search specific chats, download media, and automate responses using a local authenticated session.

    This download includes the agent skill logic, setup documentation, and the MIT license; however, you must separately install the `tg-harness` runtime and complete a local Telegram login to generate your own session files.

    The skill requires Python 3.12 or higher and is compatible with macOS and Linux systems; it is designed to work with any AI agent capable of executing local Python scripts through a runtime harness.

    The skill operates with the full permissions of your Telegram account, though it includes built-in instructions for the agent to verify targets and requests before performing destructive actions like deleting or editing messages.

    No, your Telegram credentials and session files are stored locally on your machine and are never included in the skill download or transmitted to the marketplace.

    New in Workflow Automation

    Free