Automate Telegram with Claude Code
Send messages to channels and groups, share media, schedule posts with precise timing, and automate your Telegram presence — just by asking Claude Code via the Bot API.
Please make sure there is always a human in the loop.
Post to Telegram in Seconds
Setup, then just ask
# One-time setup
npx skills add gitroomhq/postiz-agent
export POSTIZ_API_KEY=your_api_key
# Then just ask Claude Code:
> Send the launch announcement to my
Telegram channel tomorrow at 9am
Claude Code: Done! Your Telegram post is scheduled.Telegram-Specific Features
Channel Messaging
Post messages directly to your Telegram channels. Reach all subscribers with announcements, updates, and content.
Group Messaging
Send messages to Telegram groups. Keep your community engaged with scheduled posts and automated content delivery.
Bot-Powered
Powered by the Telegram Bot API via BotFather. Create a bot, add it to your channel or group, and start posting just by asking Claude Code.
Media Sharing
Share images, videos, and documents alongside your messages. Upload media through Postiz and include it in your Telegram posts.
Scheduled Messages
Schedule messages for optimal delivery times with ISO timestamps. Plan your Telegram content calendar in advance.
Minimal Config
Telegram uses a streamlined setup — once connected, Claude Code routes messages to the right channel automatically. No complex platform-specific settings required.
How It Works
You describe what you want in plain language and Claude Code handles the Postiz calls for you. Here is how a typical conversation goes.
Set Up Your Telegram Bot
Create a bot using BotFather on Telegram, then add it to your channel or group as an administrator. Connect it to Postiz through the dashboard and you are ready to go.
Example conversation
> Is my Telegram account connected to Postiz?
Claude Code: Yes — your Telegram account is connected
and ready. Want me to post something?Send Your First Message
Post a message to your Telegram channel or group. Claude Code handles the routing — no additional settings needed for basic text messages.
Example conversation
> Draft a Telegram post about our new
feature launch
Claude Code: Here's a draft for Telegram:
"We just shipped something big..."
Want me to add media and schedule it?Schedule Messages
Schedule Telegram messages for future delivery using ISO timestamps. Perfect for content calendars, announcements, and automated updates.
Example conversation
> Yes — add screenshot.png and schedule
it for tomorrow at 9am
Claude Code: Done! Scheduled on Telegram for
tomorrow at 9:00 AM.Telegram Settings Reference
Telegram uses a minimal configuration. Once your bot is connected, Claude Code routes messages to the right channel or group — there is nothing else to set.
| Field | Type | Description |
|---|---|---|
__type | string | Must be "telegram" to identify the platform (if using settings) |
Telegram's simplicity is a feature — your bot token and channel/group association are configured once in the Postiz dashboard. After that, just use the integration ID to route messages.
Common Configurations
Copy-paste these commands for common Telegram posting scenarios.
Simple Channel Announcement
Example
> Post "Excited to announce our new feature!" to
Telegram and LinkedIn tomorrow at 9am, then schedule
a daily tip on Telegram every weekday at 10am
Claude Code: Done! Scheduled:
- Telegram + LinkedIn: tomorrow 9:00 AM
- Daily tips on Telegram: Mon-Fri 10:00 AMScheduled Morning Update
Example
> What's scheduled on Telegram this week?
Claude Code: 6 posts on Telegram: the announcement tomorrow
at 9:00 AM and daily tips Mon-Fri at 10:00 AM.
Want me to move or cancel any of them?Media Post with Caption
Example
> What's scheduled on Telegram this week?
Claude Code: 6 posts on Telegram: the announcement tomorrow
at 9:00 AM and daily tips Mon-Fri at 10:00 AM.
Want me to move or cancel any of them?Multi-Channel Broadcast
Example
> What's scheduled on Telegram this week?
Claude Code: 6 posts on Telegram: the announcement tomorrow
at 9:00 AM and daily tips Mon-Fri at 10:00 AM.
Want me to move or cancel any of them?What is Claude Code?
Claude Code is Anthropic's agentic coding tool that lives in your terminal. It handles software engineering tasks — writing features, fixing bugs, and answering questions about your codebase — and it can run shell commands and MCP tools like Postiz.
Terminal & IDE Native
Claude Code runs in your terminal, with extensions for VS Code and JetBrains. You type what you want in plain English and it handles Postiz for you.
Agentic Execution
Claude Code plans and works through multi-step tasks on its own — discovering channels, uploading media, and scheduling posts — and asks for permission before it acts.
Parallel Tasks
Run several Claude Code sessions side by side, or spawn subagents in one. Schedule posts to different platforms while it handles other coding work.
How Postiz Works with Claude Code
Claude Code discovers Postiz through the Postiz skill or the Postiz MCP server. It reads the SKILL.md (or the MCP tool list) to learn what it can do, then chains calls together for social media workflows.
- ✓Install the Postiz skill, or add the Postiz MCP server with claude mcp add
- ✓Claude Code reads the SKILL.md and learns all Postiz commands
- ✓POSTIZ_API_KEY must be set in environment
- ✓Claude Code asks for permission before running commands
- ✓Works alongside your coding tasks in parallel
Install Postiz
# Option A: add the Postiz MCP server
claude mcp add --transport http postiz https://mcp.postiz.com/mcp-oauth-dynamic
# Option B: install the Postiz skill
npx skills add gitroomhq/postiz-agent
export POSTIZ_API_KEY=your_api_key
# Then just ask
claude "list my social media integrations"Telegram Posting with Claude Code
Tell Claude Code what to post from your terminal or IDE — it discovers your integrations via Postiz and handles the entire publishing workflow.
Just Ask Claude Code
Terminal and IDE integration
Tell Claude Code what to post from your terminal or IDE — it discovers your integrations via Postiz and handles the entire publishing workflow.
Claude Code CLI
$ claude "Post to Telegram about our
new feature launch, schedule for
tomorrow at 9am"
Claude Code: I'll handle that.
Found your Telegram integration.
Composing and scheduling the post.
Done! Your post is scheduled.
Post ID: abc-123Parallel Tasks
Multiple tasks at once
Claude Code runs headless with claude -p, so several tasks can run in parallel. Schedule posts to different platforms while it works on other coding tasks.
Claude Code Parallel Tasks
# Run multiple posting tasks in parallel
$ claude -p "Schedule a post about our
launch to X for tomorrow 9am" &
$ claude -p "Write a LinkedIn article
about our new feature and schedule
for tomorrow noon" &
$ claude -p "Fix the bug in auth.ts"
# All three tasks run simultaneouslyWhy Claude Code + Postiz for Telegram
Claude Code's autonomous execution makes Postiz a natural fit. The agent reads the SKILL.md to understand every available command, then autonomously chains them together for Telegram messaging workflows.
- ✓Runs in your terminal or IDE — just type what you want
- ✓Permission-based execution — you stay in control
- ✓Parallel task support — post while coding
- ✓Reads SKILL.md for automatic command discovery
- ✓Cross-post to Telegram + other platforms in a single session
- ✓Powered by Claude — Anthropic's most capable models
SKILL.md (auto-discovered)
---
name: postiz
description: Social media automation
CLI for scheduling posts across
30+ platforms including Telegram
metadata:
claude-code:
requirements:
env:
- POSTIZ_API_KEY
binaries:
- postiz
---
# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>
# Telegram
# Minimal settings — integration ID
# handles channel/group routing.
# Bot setup via BotFather.Also Works with Claude Cowork
Postiz works with any AI agent that can run commands or call MCP tools — you ask, the agent does the work. That includes Claude Cowork, Anthropic's desktop agent — no terminal needed.
Claude Cowork
by Anthropic
Claude Cowork reads the Postiz skill so it knows what it can do, then autonomously discovers your Telegram integration, composes your message, uploads any media if needed, and sends it to your channel or group.
Claude Cowork
> Send an announcement to my Telegram
channel about our new feature launch,
include the screenshot, schedule for 3pm
Claude Cowork: Done! Scheduled on Telegram for
tomorrow at 9:00 AM.Telegram + Other Platforms
Send a Telegram message and post to social media simultaneously. Each platform gets its own settings.
Example
> What's scheduled on Telegram this week?
Claude Code: 6 posts on Telegram: the announcement tomorrow
at 9:00 AM and daily tips Mon-Fri at 10:00 AM.
Want me to move or cancel any of them?Start posting to Telegram
Install Postiz Agent and automate your Telegram channel messaging with AI-powered scheduling and delivery.
Ready to get started?
Grow your social media presence with Postiz.
Schedule, analyze, and engage with your audience.
Open-source social media scheduling tool
AI Agents
