NEW: the postqueen MCP server is live. Connect it in a minute
Telegram

Automate Telegram with Gemini CLI

Queue Telegram messages from the terminal. Gemini CLI runs every postqueen command and reads the JSON back, so it can check what it scheduled.

Quick start

Run the postqueen CLI directly, or add the MCP endpoint to your Gemini CLI settings and ask for Telegram messages in plain language.

MCP supported
Terminal or settings.json
npm install -g postqueen
export POSTQUEEN_API_KEY=your_api_key
 
# Or MCP, in your Gemini CLI settings:
# { "mcpServers": { "postqueen": {
# "url": "https://api.postqueen.ai/mcp/KEY"
# } } }

What Gemini CLI can run on Telegram

Telegram commands it can verify

Gemini CLI runs postqueen and reads the JSON back, so it can confirm which Telegram messages exist and at what times instead of reporting success it did not check.

Windows that fit Telegram

Tell Gemini CLI when your channels and groups are busiest and it schedules messages into that window on Telegram, day after day, without reminders.

The right channels and groups, every time

Gemini CLI lists your connected channels and groups before it posts, so messages land exactly where they should and announcements stay consistent.

Drafts until you are ready

Ask Gemini CLI for drafts only. They sit on the postqueen calendar unscheduled, so you can edit them and pick the time yourself, and nothing reaches your subscribers on Telegram until you do.

Three steps to a full queue

Step 1

Discover Telegram

Gemini CLI calls postqueen to list your connected channels and groups and sees what Telegram supports, so drafts start from real capabilities, not guesses.

Step 2

Draft with Gemini CLI

Give it the brief. The agent writes Telegram-shaped messages and proposes publish times that match when your subscribers are around.

Step 3

Check and publish

Look over the queue on the postqueen calendar and change anything you want. postqueen publishes each post at its time, and Gemini CLI can pull the results after.

What Telegram allows

Gemini CLI reads these limits from postqueen before it composes, so a draft that would be rejected never reaches the queue.

Text length
Up to 4,096 characters per message via the Bot API
Caption length
Up to 1,024 characters on photos and videos
Albums
2 to 10 photos or videos per media group
File size
Bots can send files up to 50 MB (photos up to 10 MB)
Bot permissions
Admin rights with Post Messages in each target channel
Audience scale
Unlimited channel subscribers, groups up to 200,000 members
Telegram

Everything postqueen does on Telegram

Scheduling, AI drafts, analytics and team roles, in one guide.

Read the Telegram guide
F.A.Q.

Frequently asked questions

How does Gemini CLI connect Telegram to postqueen?

Over MCP, registered once in Gemini CLI's own config so the Telegram tools are there in every session. It also runs commands, so the CLI covers the same Telegram messages when you would rather script them; both use the same API key.

Can Gemini CLI schedule Telegram messages at exact times?

Yes. Give it exact slots or a rule like mornings at nine and it sets publish times on the messages it creates, keeping your channels and groups active on a steady rhythm.

Will Gemini CLI publish to Telegram on its own?

Only if you ask it to. Tell it to save drafts and nothing is scheduled: the messages wait on the calendar until you set a time. Tell it to schedule, and they go out at the times you can see, which is the setup most people move to once they trust the output.

Can one brief cover Telegram and other channels too?

Yes. postqueen connects 30 channels, so Gemini CLI can turn the same brief into Telegram messages plus adapted versions for every other channel you run.

Does Gemini CLI access cost extra on postqueen?

No. The agent uses your regular API key and plan limits: unlimited posts on every plan, and channel counts from 5 on Creator up to uncapped on Ultimate.

Is there a free trial for Telegram scheduling?

Yes. Every cloud plan starts with a 7-day free trial and unlimited posts. Self-hosting the open source version is free.

How does postqueen post to Telegram?

Through a bot using the official Telegram Bot API. You add the bot to your channel or group, promote it to admin with the Post Messages right, and scheduled posts publish automatically. Setup takes a couple of minutes per channel.

Ready to get started?

Queue this week's posts in minutes, or hand the whole thing to your favorite AI. postqueen keeps publishing either way.

Seven days free. Cancel in one click from settings.