- Home
- Skills
- Workflow Automation
- telegram-notify: agent alerts on Telegram
Works with the AI Agents you already use
telegram-notify: agent alerts on Telegram
Your AI agent pings you on Telegram when the job is done. One command, your own bot, no cloud.
Free
telegram-notify: agent alerts on Telegram
Example session with this skill installed
Send a Telegram notification saying the database migration is complete with 450 rows processed and 0 errors. Use a code block for the row count.
- Read your context and instructions
- Compiled the telegram-notify
I have sent the notification to your Telegram bot.
Notification Sent
The following payload was delivered to chat ID 123456789:
Status: Database migration complete
- Scope: Production DB
- Result: Success
- Details:
450 rows processed - Errors:
0
Next steps
- Check your Telegram app to confirm receipt of the message.
- Review the migration logs in the
logs/directory for a full row-by-row audit. - Use
python3 scripts/notify.py --dry-runif you want to test future message formatting.
Connects securely to your tools. The creator never sees your data.
About this skill
You ask your agent for a long task, then you sit there watching logs — or you walk away and come back to a failure you could have handled an hour earlier.
telegram-notify gives the agent one command to tell you what happened, on the phone you already have open:
python3 scripts/notify.py "Deploy finished: 42 tests green, 0 failures"
It sends through your own Telegram bot. No account with us, no hosted service, no message broker: the only destination is api.telegram.org and the token you create with @BotFather.
What you get
SKILL.md— when to use it, how to set it up, how to write a message a human reads in five seconds.scripts/notify.py— sender with Markdown → Telegram HTML conversion, 4096-character chunking, automatic plain-text fallback, rate-limit retry and exit codes 0/1/2.scripts/check.py— verifies token and chat id and sends one test message.references/— what formatting survives Telegram, plus message patterns (job done, failure, blocked, digest).examples/transcript.md— a real session, trimmed.
Works with
Claude Code, Gemini CLI, Codex CLI, Cursor, Windsurf, Cline, Copilot-style agents, or any agent that can run a shell command. Copy the folder into the agent's skills directory; the description carries the trigger phrases.
Tested end to end with Claude Code 2.1.322 and Gemini CLI 0.68.0: both found the skill from a natural request ("send me a message when the build finishes"), executed it, and the message arrived formatted.
Setup (3 minutes)
- Create a bot with @BotFather and copy the token.
- Send it a message and read your chat id from
getUpdates. - Put both in a
.envnext toSKILL.md(or export them). - Run
python3 scripts/check.pyand check your phone.
Why this one
- No dependencies. Python 3.8+, standard library only.
- Readable. Two scripts you can audit in a minute; no obfuscation, no package installs.
- Honest. A 401 is reported as a 401, never as a "sent".
- Formatted. Bold, code, links and bullets arrive as Telegram HTML; Markdown tables are flattened because they are unreadable on a phone.
Requirements
- Python 3.8 or newer.
- A Telegram account (a bot token is free).
- Outbound HTTPS to
api.telegram.orgonly.
Privacy
The scripts read the message you give them and two configuration values. They do not scan your project, read other files, or contact any other host. No telemetry, no background process.
Requires Python 3.8+. User must provide their own Telegram bot token and chat ID. No support for media attachments or document uploads.
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
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 4 days ago
- Free with an Agensi account
Requires
Permissions
Allowed Hosts