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

Automate X with Gemini CLI

Queue X posts 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 X posts 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 X

X commands it can verify

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

Windows that fit X

Tell Gemini CLI when your followers are most active and it schedules posts into that window on X, day after day, without reminders.

Media attached, sized right

Images upload in the same postqueen call, so X posts arrive with their media in place instead of a bare link.

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 followers on X until you do.

Three steps to a full queue

Step 1

Discover X

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

Step 2

Draft with Gemini CLI

Give it the brief. The agent writes X-shaped posts and proposes publish times that match when your followers 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 X allows

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

Post length
280 characters on a standard account, up to 25,000 characters with X Premium
Media per post
Up to 4 images, or 1 GIF, or 1 video (images and GIFs cannot be mixed)
Video length
Up to 2 minutes 20 seconds on a standard account, longer for Premium subscribers
Threads
Chain any number of posts, published in order as native replies
Alt text
Up to 1,000 characters of image description per attachment
API access
Publishing runs on the official X API, so self-hosted installs connect with their own X developer app
X

Everything postqueen does on X

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

Read the X guide
F.A.Q.

Frequently asked questions

How does Gemini CLI connect X to postqueen?

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

Can Gemini CLI schedule X posts at exact times?

Yes. Give it exact slots or a rule like mornings at nine and it sets publish times on the posts it creates, so your followers see them at the right moment.

Will Gemini CLI publish to X on its own?

Only if you ask it to. Tell it to save drafts and nothing is scheduled: the posts 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 X and other channels too?

Yes. postqueen connects 30 channels, so Gemini CLI can turn the same brief into X posts 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.

Can I self-host X scheduling, and is there a free trial?

Both. Every cloud plan starts with a 7-day free trial and you can cancel anytime. The open source version is free to self-host with Docker, and for X you register your own developer app so the connection runs on API access you control.

Which X formats can postqueen schedule?

Single posts, threads, images, GIFs and native video. You compose once, preview how the post will look, and postqueen publishes it in X's native format at the scheduled time.

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.