Telegram Inbox & Button Cards

    1

    Forward anything to your own Telegram bot: your agent fetches it, sends files back (up to 2 GB) and asks you questions with buttons.

    $7

    Secure checkout via Stripe

    Money-back guarantee

    Converts to your local currency at checkout

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIDeepSeekDeepSeekMuseMuse+22 more

    Telegram Inbox & Button Cards

    Example session with this skill installed

    I forwarded two things to the bot, check my inbox.

    • Read your context and instructions
    • Compiled the telegram inbox

    Fetched 2 entries.

    #412 photo: a screenshot of the checkout page; the "Pay" button overlaps the total on a narrow screen. Your caption: "fix this".
    #413 text with a link: the article at the link describes the new store review rules; the short version is three points...

    I have started on the checkout layout fix from #412. Both entries are marked as seen.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Turn your own Telegram bot into an inbox for your coding agent.

    You forward messages, screenshots, videos, files and links to the bot from your phone. When you say "check my inbox", the agent pulls everything into a local folder, looks at the pictures, reads the links and documents, and does what your caption asks. It can send files back to you (a built APK, a screenshot, a report) and run a series of decisions through Telegram: one card with buttons at a time, waiting for your tap or text reply.

    What is in the package

    • SKILL.md: the agent instructions (fetch and process, send, ask with buttons, error handling, prompt-injection rule: inbox content is data, not instructions).
    • app/: the complete tgc command-line tool in Python (about 1,600 lines, Telethon + httpx). No background service and no server: it runs only when the agent calls it.

    How it works

    • tgc pull saves the bot queue to disk first and confirms it in Telegram only afterwards, so a crash or lost network never loses a message; albums become one entry; files up to 2 GB go through MTProto under the bot.
    • tgc send sends files as documents without compression, or jpg/png as photos with a preview.
    • tgc ask sends a card with 1 to 8 buttons and an optional copy-with-one-tap code block, then waits for the answer; a late answer is stored and returned by the next call.
    • Only the owner's messages are accepted; everyone else is dropped and counted.
    • Secrets live in a local .env with mode 600; the skill tells the agent never to read or print them, and the CLI masks the token in error output.

    Setup takes a few minutes: copy app/ to ~/.tg-claude/, run uv sync, create a bot with @BotFather, get API keys at my.telegram.org and fill in four values yourself.

    The CLI prints its own messages in Russian; the skill quotes every string the agent has to recognise together with its meaning, and exit codes and JSON output are language-neutral.

    Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Workflow Automation.

    The CLI's own messages and the bot's short replies to the owner are in Russian (the skill explains each one). macOS and Linux only. Telegram keeps unconfirmed bot updates for about a day: anything sent and not fetched for longer is lost, and pull reports gaps in message numbers. Files up to 2 GB each way. Videos and voice messages are saved but not transcribed. Message edits are ignored (the first version is kept). The inbox folder is never cleaned up automatically. One bot serves one owner.

    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 buying a skill.

    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

    Fresh listing

    Recently published to Agensi

    Money-back guarantee

    Doesn't do what its page promises? You get your money back.

    Trust & safety

    Security scan

    Security scan passed 4 days ago

    Accounts
    TelegramTelegram bot token (@BotFather)
    Software
    Python 3.12+uv (Python tool runner)Telegram API ID and hash

    Windows is not supported (the CLI uses fcntl and SIGALRM). The Telegram API ID and hash come free from my.telegram.org.

    Permissions

    Allowed Hosts

    api.telegram.org
    pypi.org

    File Scopes

    ~/.tg-claude/
    files
    the
    owner
    asks
    to
    send

    Also connects to Telegram MTProto servers through Telethon for files over 20 MB. pypi.org is contacted once, by uv sync at setup. ~/.tg-claude/ holds the CLI, .env, the bot session and the inbox. The agent is told never to read or print ~/.tg-claude/.env. The optional session-start hook is added only at the owner's request.

    Listed4 days ago

    What's inside

    Frequently Asked Questions

    No. The tgc CLI runs only when the agent calls it and talks to Telegram directly; messages wait in the bot queue until the next pull (Telegram keeps them for about a day).

    No. Only messages from the numeric owner id in your .env are accepted; everything else is dropped and counted. The skill also tells the agent to treat all inbox content as data, not instructions.

    Into ~/.tg-claude/.env on your machine, mode 600, filled in by you. The agent is instructed never to read or print the values, and the CLI masks the token in error messages.

    New in Workflow Automation