Post to Telegram from Claude Code

Claude Code can send and schedule Telegram messages through Postiz. Add the Postiz MCP server with one command, sign in with OAuth, connect your Telegram channel or group in Postiz, and ask Claude Code to post a release update, share a screenshot, or schedule a daily tip, all from the terminal.

Setup Guide GitHub

Please make sure there is always a human in the loop.

Last updated: September 2026

How to post to Telegram from Claude Code

Add the Postiz MCP server to Claude Code once, sign in with OAuth, connect Telegram in Postiz, and then describe the post in plain language. Setup takes about a minute.

Setup once, then just ask

# One-time setup: add the Postiz MCP server (OAuth, no API key)
claude mcp add --transport http postiz https://mcp.postiz.com/mcp-oauth-dynamic

# Or install the Postiz skill instead
npx skills add gitroomhq/postiz-agent
export POSTIZ_API_KEY=your_api_key

# Then ask Claude Code:
> Post "v2.4 is live, changelog:
  https://example.com/changelog" to our
  Telegram channel now

Claude Code: Done! Message sent to your
  Telegram channel.

What can Claude Code do on Telegram?

On Telegram, Claude Code can post text and media messages to the channels and groups you have connected in Postiz, now or at a scheduled time.

📢

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 does Claude Code post to Telegram through Postiz?

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	Required	Description
`__type`	string	Yes	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 AM

Scheduled 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?

Example prompts for Telegram in Claude Code

These are prompts you can type into a Claude Code session, or pass to claude -p in a script. Claude Code reads your repo, calls Postiz, and confirms before publishing.

Release update with media

Claude Code

> Post the top 3 changes from CHANGELOG.md to
  our Telegram channel with ./assets/release.png,
  tomorrow at 9am

Claude Code: Uploaded release.png. Telegram
  message scheduled for tomorrow 9:00 AM.

Daily tip series

Claude Code

> Read docs/tips.md and schedule one tip per
  day to our Telegram channel at 10am for the
  next 7 days

Claude Code: Scheduled 7 Telegram messages,
  one per day at 10:00 AM.

Uptime alert, headless

Claude Code

$ claude -p "Post 'Maintenance window starts at
  02:00 UTC' to our Telegram channel via Postiz."

# Fire this from a cron job before maintenance

Telegram limits and gotchas to know

Telegram posting through Postiz uses the Telegram Bot API, which brings a few practical rules.

✓The Postiz bot must be added to your channel or group with permission to post before Claude Code can send anything.
✓Telegram text messages are limited to 4,096 characters; Claude Code keeps long updates under the limit or splits them.
✓Telegram has no extra Postiz settings beyond the channel type, so just name the channel and the message.
✓Media is uploaded through Postiz, so reference a local file or URL.

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.

Not the same as Claude Cowork (Anthropic's desktop agent for knowledge workers) or the Postiz connector for Claude.ai (chat in the browser or desktop app). Claude Code runs in your terminal and IDE and can read your repository while it writes Telegram posts.

💻

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 discovers the Postiz tools over MCP, or reads SKILL.md when you use the skill
✓MCP route: sign in with OAuth, no API key. Skill route: set POSTIZ_API_KEY
✓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-123

💻

Parallel 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 simultaneously

Why 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. That includes Claude Cowork, Anthropic's desktop agent, and the Claude.ai connector. See the agents overview for every supported agent.

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.

Post to Telegram and other platforms from Claude Code

One request can schedule the same content to Telegram and other channels, and each platform keeps its own settings. Every platform below has its own Claude Code guide.

Example

> Post "Excited to announce our new feature!" to
  Telegram and Discord tomorrow at 9am, then schedule
  a daily tip on Telegram every weekday at 10am

Claude Code: Done! Scheduled:
  - Telegram + Discord: tomorrow 9:00 AM
  - Daily tips on Telegram: Mon-Fri 10:00 AM

Post to Discord from Claude Code→Post to Slack from Claude Code→Post to X from Claude Code→Post to Whop from Claude Code→Post to Skool from Claude Code→

See all 25 platforms in the Claude Code social media guide, compare agents on the AI agents overview, read about the Postiz MCP server, or check pricing. For the channel itself, seeTelegram scheduling features in Postiz.

Telegram and Claude Code: frequently asked questions

How do I post to a Telegram channel from Claude Code?

Add the Postiz MCP server to Claude Code, sign in to Postiz with OAuth, and connect your Telegram channel or group in Postiz by adding the Postiz bot. Then ask Claude Code to send or schedule a message. It drafts the text, uploads any media, and sends it through Postiz.

Can Claude Code post to Telegram groups as well as channels?

Yes. Postiz connects both Telegram channels and groups through its bot, and each one appears as a separate channel in Postiz. Tell Claude Code which one you mean, or ask it to list your connected Telegram channels first, then it sends the message to the right place.

Can I schedule a series of Telegram messages with Claude Code?

Yes. Describe the series, for example one tip per day at 10am for a week, and point Claude Code at a file with the content. It creates one scheduled message per day through Postiz. Each message shows in your Postiz calendar, where you can edit or cancel it.

Can Claude Code send Telegram alerts from a script?

Yes. Use headless mode, claude -p, from cron or a CI job with a prompt describing the message and the Telegram channel. Claude Code sends it through Postiz and exits. The Postiz MCP server or skill has to be configured on the machine that runs the script.

Start posting to Telegram

Install Postiz Agent and automate your Telegram channel messaging with AI-powered scheduling and delivery.

Get Started