notify-telegram

Register Claude Code sessions with a Telegram webhook daemon for notifications.

4|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/johnnymo87/workstation --skill notify-telegram
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notify-telegram
Source: https://github.com/johnnymo87/workstation/tree/main/assets/claude/skills/notify-telegram
Command: npx skills add https://github.com/johnnymo87/workstation --skill notify-telegram

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl.

What problem does it solve?

This skill enables Telegram notifications for Claude Code sessions, ensuring you receive timely alerts when tasks complete without switching apps.

Core Features & Use Cases

  • Real-time alerts: Notify your phone when Claude finishes a task or session.
  • Session-based labeling: Each notification is tied to the current Claude session via a label.
  • On-demand setup: Quick enrollment using the provided register script, with optional Neovim integration.

Quick Start

Run the registration script with your label: ~/.claude/skills/notify-telegram/register.sh "$ARGUMENTS" Replace "$ARGUMENTS" with the label (e.g., "myproject"). If empty, uses current directory name.

Frequently Asked Questions about notify-telegram

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get Telegram notifications when Claude Code tasks complete?

This skill enables Telegram notifications for Claude Code sessions by registering your current session with a local webhook daemon on port 4731. Run the registration script with a label, and you'll receive real-time alerts on your phone when tasks finish without leaving your editor.

What setup do I need to use Telegram notifications with Claude Code?

You need a running Telegram webhook daemon listening on port 4731, access to your Claude transcript directory to fetch the session ID, and curl installed. The skill handles session registration and labeling automatically once the daemon is active.

Can I integrate Telegram notifications with Neovim?

Yes, this skill includes optional Neovim integration. After registering with the script, it stores a runtime alias for hooks that works within your Neovim environment to trigger Telegram alerts for Claude sessions.

How does session-based labeling work for Telegram alerts?

Each Telegram notification is tied to your current Claude session via a custom label you provide during registration. If you don't specify a label, it uses your current directory name, so notifications clearly identify which project or task they relate to.

What happens if the webhook daemon stops running?

The skill requires an active webhook daemon on port 4731 to function. If the daemon is unavailable, session registration and notifications will fail. Ensure the daemon is running before registering a new session.