Official agent skill

Telegram

by zapier in zapier/connectors

Agent-callable Telegram bot tools — send messages, media, locations, contacts, and polls; edit, delete, forward, copy, and pin messages; resolve chats, members, and files.

OfficialElastic-2.0Auto-check passedProductivity & Automation

Install Telegram

skills CLI
$ npx skills add zapier/connectors --skill telegram -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install zapier/connectors telegram --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/zapier/connectors.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/telegram .claude/skills/telegram && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
telegram
GitHub stars
176
Token cost
~3.9k tokens
SKILL.md length
1,262 words
Files
67 (incl. scripts, references)
Skills in repo
30
Repo updated
First seen
Licence
Elastic-2.0

At a glance

Agent-callable Telegram bot tools — send messages, media, locations, contacts, and polls; edit, delete, forward, copy, and pin messages; resolve chats, members, and files.

  • The user mentions Telegram
  • SKILL.md covers When to use this, Setup, Scripts and Disambiguation & refusals, plus 3 more sections
  • Runs TypeScript and JavaScript scripts from its folder; calls npm, npx and git; reaches api.telegram.org
  • Wants a bot to post

What it does

Telegram is an agent skill from zapier/connectors, published by the product's own GitHub organization. Agent-callable Telegram bot tools — send messages, media, locations, contacts, and polls; edit, delete, forward, copy, and pin messages; resolve chats, members, and files. Use when the user mentions Telegram or wants a bot to post, manage, or look up Telegram content — including requests that don't name Telegram explicitly, e.g. "message the team channel", "post this update to the group".

Its SKILL.md is about 3.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 70 other files, including scripts and reference files (for example `.claude-plugin/plugin.json`, `.mcp.json` and `CHANGELOG.md`). Compatibility notes: Run npm install --omit=dev in this directory, then node cli.js. The TypeScript source needs Node.js 22.18+; on older Node, run cli.js for build-it-yourself /…

It sits in Productivity & Automation, covering Chatbots and conversational support. It works with Telegram and Zapier. The repository describes itself as: Connect your agent to the apps you already use - with or without Zapier.

When your agent uses it

  • The user mentions Telegram
  • Wants a bot to post
  • Look up Telegram content — including requests that dont name Telegram explicitly

Example prompts

  • “t name Telegram explicitly, e.g.”
  • “post this update to the group”
  • “/telegram”

Requirements

  • Node.js
  • Compatibility (from SKILL.md): Run `npm install --omit=dev` in this directory, then `node cli.js`. The TypeScript source needs Node.js 22.18+; on older Node, run `cli.js` for build-it-yourself / prebuilt / alternative-runtime options.

What it can do on your machine

Read from SKILL.md and the folder at commit e48d26f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (TypeScript and JavaScript, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • npm
    • npx
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.telegram.org

    Also links to:

    • core.telegram.org
    • agentskills.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Run `npm install --omit=dev` in this directory, then `node cli.js`. The TypeScript source needs Node.js 22.18+; on older Node, run `cli.js` for build-it-yourself / prebuilt / alternative-runtime options.

    From compatibility in the SKILL.md frontmatter.

Context cost

Telegram loads about 3.9k tokens when it runs, and up to ~14k if it reads all its reference files. Until then it costs about 100 tokens; SKILL.md has 1,262 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~100
When it runs · the whole SKILL.md, loaded when a task matches
~3.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~14k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Its licence (Elastic-2.0) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,262 words (~3,872 tokens).

“Scripts for a Telegram bot, against the Telegram Bot API (https://api.telegram.org/bot/). Send text, media, locations, contacts, and polls; edit, delete, forward, copy, and pin messages; and resolve the chats, members, and files a bot interacts with. Every script acts as…”

— opening of SKILL.md by zapier, Elastic-2.0
name
telegram
compatibility
Run `npm install --omit=dev` in this directory, then `node cli.js`. The TypeScript source needs Node.js 22.18+; on older Node, run `cli.js` for build-it-yourself / prebuilt / alternative-runtime options.
license
Elastic-2.0
metadata.title
Telegram
metadata.source
https://github.com/zapier/connectors/blob/main/apps/telegram/SKILL.md
metadata.zapier-app-key
TelegramCLIAPI
metadata.api-docs
https://core.telegram.org/bots/api

Read the full SKILL.md on GitHub

Files

SKILL.md and 66 other files (scripts, references) in apps/telegram of zapier/connectors.

  • SKILL.md
  • .claude-plugin/plugin.json
  • .mcp.json
  • CHANGELOG.md
  • LICENSE
  • NOTICE
  • README.md
  • cli.js
  • cli.ts
  • connections.ts
  • evals/evals.json
  • evals/results.md
  • index.ts
  • lib/telegram.ts
  • package.json
  • references/telegram-api-gotchas.md
  • references/use-as-cli.md
  • … and 50 more

Open the folder on GitHubat commit e48d26f

Compare with similar skills

Telegram next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Telegram compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Telegram this skillzapier/connectors176—~3.9kAutomated safety check: PassElastic-2.0
Pytdbotpytdbot/client137—~4.3kAutomated safety check: PassMIT
Setupterranc/claude-telegram-bot-bridge134—~1.5kAutomated safety check: NotesNone
MuseKevPH2026/muse-catch128—~1.6kAutomated safety check: NotesAGPL-3.0
MuseKevPH2026/muse-catch128—~865Automated safety check: PassAGPL-3.0
Add Telegram API Actionvendelieu/telegram-bot249—~974Automated safety check: PassApache-2.0

Similar skills

  • Pytdbot

    pytdbot/client

    Write Telegram bots and userbots with Pytdbot (async TDLib wrapper with high-level helpers; not the Telegram Bot API).

    137 GitHub stars~4.3k tokensUpdated 9 days ago
    Productivity & AutomationAuto-check passed
  • Setup

    terranc/claude-telegram-bot-bridge

    Install and configure the Telegram Skill Bot. An agent skill from terranc/claude-telegram-bot-bridge.

    134 GitHub stars~1.5k tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check: notes
  • Muse

    KevPH2026/muse-catch

    Muse · Catch — AI 灵感捕手。浏览器插件 + 任意 Agent(Telegram/WhatsApp/Discord…)一键捕获灵感,AI自动提炼,Web Dashboard浏览。分级LLM路由:Agent内置LLM隐私分析 + TokenRouter云端分布式调用。当用户说「灵感」「捕获」「Muse」「Catch」「记下来」「收藏」「稍后读」时自动触发。

    128 GitHub stars~1.6k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check: notes
  • Muse

    KevPH2026/muse-catch

    Muse · Catch — AI灵感捕手。浏览器插件+Telegram Bot一键捕获,AI自动提炼,Dashboard浏览+DNA雷达+OPC Market。当用户说「灵感」「捕获」「Muse」「Catch」「记下来」「收藏」时触发。

    128 GitHub stars~865 tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Add Telegram API Action

    vendelieu/telegram-bot

    Adds a new Telegram Bot API method (action class and top-level functions).

    249 GitHub stars~974 tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed
  • Actionize

    infranodus/skills

    Turn insights, findings, or research into an actionable plan with deadlines and scheduled Telegram reminders.

    119 GitHub stars~3.8k tokensUpdated 17 days ago
    Productivity & AutomationAuto-check: notes

More from zapier/connectors

All 30 skills in this repo
  • Google Ads

    zapier/connectors

    Official

    Agent-callable Google Ads tools — search campaigns, ad groups, and ads via GAQL, build performance reports, manage campaign status and budgets, and set up conversion tracking.

    176 GitHub starsUsed in 1 repo~3.7k tokens
    Auto-check passed
  • Linear

    zapier/connectors

    Official

    Agent-callable Linear tools — create, update, find, and comment on issues; manage projects; and resolve teams, states, labels, users, and cycles.

    176 GitHub starsUsed in 1 repo~5.1k tokens
    Auto-check passed
  • Alpaca

    zapier/connectors

    Official

    Agent-callable Alpaca trading tools — place and manage stock, crypto, and options orders, read account balances, positions, and portfolio history, look up assets and market hours, and read watchlists.

    176 GitHub stars~4.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Clay

    zapier/connectors

    Official

    Agent-callable Clay tools — create, update, and find rows in Clay tables, and navigate workspaces, tables, views, and users.

    176 GitHub stars~3.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Discord

    zapier/connectors

    Official

    Agent-callable Discord tools — send and manage messages, start threads and forum posts, manage channels, members, and roles, and post via webhooks.

    176 GitHub stars~4.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Dropbox

    zapier/connectors

    Official

    Agent-callable Dropbox tools — upload, organize, find, and share files and folders.

    176 GitHub stars~4.4k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Telegram

What does Telegram do?

Agent-callable Telegram bot tools — send messages, media, locations, contacts, and polls; edit, delete, forward, copy, and pin messages; resolve chats, members, and files. Telegram is an agent skill from zapier/connectors, published by the product's own GitHub organization. Agent-callable Telegram bot tools — send messages, media, locations, contacts, and polls; edit, delete, forward, copy, and pin messages; resolve chats, members, and files.

When should I use Telegram?

Telegram fits situations like: the user mentions Telegram; wants a bot to post; look up Telegram content — including requests that dont name Telegram explicitly.

How do I install Telegram in Claude Code?

Run `npx skills add zapier/connectors --skill telegram -a claude-code`. Or copy the skill folder (apps/telegram in zapier/connectors) into .claude/skills/telegram in your project. Claude Code loads it when a task matches its description.

How do I install Telegram in Codex?

Run `npx skills add zapier/connectors --skill telegram -a codex`. Or copy the skill folder (apps/telegram in zapier/connectors) into .agents/skills/telegram in your project. Codex loads it when a task matches its description.

Can I use Telegram in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add zapier/connectors --skill telegram -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/telegram, .gemini/skills/telegram, .github/skills/telegram and .opencode/skills/telegram in your project.

What does Telegram need to run?

Going by SKILL.md and its folder, Telegram needs TypeScript and JavaScript for the scripts in its folder and the command-line tools its instructions call (npm, npx and git). Our summary lists: Node.js. Compatibility (from SKILL.md): Run `npm install --omit=dev` in this directory, then `node cli.js`. The TypeScript source needs Node.js 22.18+; on older Node, run `cli.js` for build-it-yourself / prebuilt / alternative-runtime options..

Does Telegram access the network?

SKILL.md names 3 domains. In commands or code: api.telegram.org; the agent is likely to contact it when it follows the instructions. As links in the text: core.telegram.org and agentskills.io. This is read from the text; nothing was executed.

Is Telegram safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Telegram use?

Telegram is published under the Elastic-2.0 licence (declared in SKILL.md).

How many tokens does Telegram use?

About 3.9k tokens (SKILL.md is roughly 15k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 10k tokens, read only when the agent opens those files.

What are the alternatives to Telegram?

Skills that share tags, products or a category with Telegram: Pytdbot (pytdbot/client, 137 stars), Setup (terranc/claude-telegram-bot-bridge, 134 stars), Muse (KevPH2026/muse-catch, 128 stars) and Muse (KevPH2026/muse-catch, 128 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Telegram?

zapier (a GitHub organization, an official publisher) maintains it in zapier/connectors, which has 176 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on August 25, 2026.

Source: zapier/connectors on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.