- Home
- Skills
- Workflow Automation
- Telegram Inbox & Button Cards
Telegram Inbox & Button Cards
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
Works with the AI Agents you already use
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 completetgccommand-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 pullsaves 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 sendsends files as documents without compression, or jpg/png as photos with a preview.tgc asksends 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
.envwith 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.
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
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
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 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
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
Requires
Permissions
Allowed Hosts
File Scopes
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.