mcpField
T
telegram

telegram

github.com/sanjay3290Productivity44886 installsUpdated 7w ago
Repository

About telegram

A Bash-based Telegram skill for sending alerts and files, reading replies, and running ask-and-wait approval flows. It uses curl and jq, with setup through a bot token and optional Claude Code hooks.

Key features

  1. 01Send messages and alerts
  2. 02Send documents and detect photos
  3. 03Read incoming messages
  4. 04Ask questions with timed options
  5. 05Configure multiple bots and targets

Use cases

  1. 01Notify a Telegram chat when Claude needs input
  2. 02Send a deployment completion alert
  3. 03Require a Telegram reply before deployment

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/sanjay3290/ai-skills --skill telegram

After installing, type/telegramin Claude Code to confirm it loaded.

Bundled filesREADME.mdscripts/telegram.sh

Details

From the project README

Telegram

Send updates, alerts, and files to Telegram; read replies; run ask-and-wait approval flows. Pure bash + curl + jq — no install beyond a bot token.

First run: scripts/telegram.sh setup (guided BotFather walkthrough).

Commands

scripts/telegram.sh send "Deploy finished ✅"                    # basic alert
scripts/telegram.sh send "low priority" --silent                # no notification sound
scripts/telegram.sh send "*bold* alert" --format md             # MarkdownV2 (falls back to plain)
scripts/telegram.sh send "hi" --to alerts --bot work            # named target + named bot
scripts/telegram.sh file report.pdf "Q3 report"                 # document (photos auto-detected)
scripts/telegram.sh read                                        # new incoming messages since last read
ANSWER=$(scripts/telegram.sh ask "Deploy to prod?" --options "Yes,No" --timeout 300)
# exit 0 = answered (stdout = answer), 2 = timeout

Config

Env vars win, then ~/.config/telegram/config (mode 600):

TELEGRAM_BOT_TOKEN=123:ABC...     # default bot
TELEGRAM_CHAT_ID=987654321        # default target
BOT_ALERTS_TOKEN=456:DEF...       # --bot alerts   (add via: setup --bot alerts)
TARGET_FAMILY=-100987...          # --to family    (any chat/group/channel id)

Replies and answers are only accepted from configured chat IDs.

Claude Code hooks (settings.json)

Ping your phone when Claude needs input, and when it finishes:

{
  "hooks": {
    "Notification": [{"hooks": [{"type": "command",
      "command": "~/.claude/skills/telegram/scripts/telegram.sh send \"🔔 Claude needs input in $(basename \\\"$PWD\\\")\""}]}],
    "Stop": [{"hooks": [{"type": "command",
      "command": "~/.claude/skills/telegram/scripts/telegram.sh send \"✅ Claude finished in $(basename \\\"$PWD\\\")\" --silent"}]}]
  }
}

Approval gate in any script/automation:

if [ "$(scripts/telegram.sh ask 'Deploy to prod?' --options 'Yes,No')" = "Yes" ]; then
  ./deploy.sh
fi

Comments

Markdown supported