Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIDeepSeekDeepSeekMuseMuse+22 more

    telegram-notify: agent alerts on Telegram

    1

    Your AI agent pings you on Telegram when the job is done. One command, your own bot, no cloud.

    Free

    Security scanned
    telegram-notify: agent alerts on Telegram

    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

    1. Check your Telegram app to confirm receipt of the message.
    2. Review the migration logs in the logs/ directory for a full row-by-row audit.
    3. Use python3 scripts/notify.py --dry-run if 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)

    1. Create a bot with @BotFather and copy the token.
    2. Send it a message and read your chat id from getUpdates.
    3. Put both in a .env next to SKILL.md (or export them).
    4. Run python3 scripts/check.py and 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.org only.

    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.

    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.

    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. 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

    Free to use

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 4 days ago

    • Free with an Agensi account

    Accounts
    Telegram
    Software
    Python

    Permissions

    Terminal / Shell
    Network Access
    Read Files
    Environment Variables

    Allowed Hosts

    api.telegram.org
    Listed5 days ago

    What's inside

    Frequently Asked Questions

    You will need a Telegram Bot token (obtained via @BotFather) and your numeric Chat ID. The skill includes a step-by-step setup guide and a verification script to ensure your credentials are working before you deploy it.

    This skill is built with standard Python 3.8 libraries, making it compatible with any AI agent framework that can execute Python scripts or shell commands. It works seamlessly across Windows, macOS, and Linux environments.

    Unlike basic API calls, this skill automatically converts Markdown into Telegram-friendly HTML and intelligently chunks messages that exceed Telegram's 4096-character limit to ensure your full report is delivered.

    Yes, you can override the default credentials using CLI flags, allowing a single agent to route different types of alerts (like errors vs. status updates) to different Telegram groups or users.

    You receive the production-ready Python notification script, an environment configuration template, a connection tester, and full documentation on integrating the skill into your existing workflows.

    New in Workflow Automation

    Free