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

Automate Instagram with Gemini CLI

Queue Instagram posts, stories and reels 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 Instagram 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 Instagram

Instagram commands it can verify

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

Windows that fit Instagram

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

Media attached, sized right

Images upload in the same postqueen call, so Instagram posts, stories and reels 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 Instagram until you do.

Three steps to a full queue

Step 1

Discover Instagram

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

Step 2

Draft with Gemini CLI

Give it the brief. The agent writes Instagram-shaped posts, stories and reels 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 Instagram allows

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

Caption length
Up to 2,200 characters per caption, with up to 30 hashtags
Carousels
Up to 10 images or videos per carousel when publishing through the API
Reels
Vertical 9:16 video, up to 3 minutes for most accounts
Feed aspect ratios
From 1.91:1 landscape to 4:5 portrait, with square 1:1 always safe
Daily API limit
Instagram allows up to 100 API-published posts per rolling 24 hours, a carousel counts as one
Account requirement
A professional account (Business or Creator) is required for API publishing
Instagram

Everything postqueen does on Instagram

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

Read the Instagram guide
F.A.Q.

Frequently asked questions

How does Gemini CLI connect Instagram to postqueen?

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

Can Gemini CLI schedule Instagram 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 Instagram 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 Instagram and other channels too?

Yes. postqueen connects 30 channels, so Gemini CLI can turn the same brief into Instagram posts, stories and reels 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 try Instagram scheduling for free?

Yes. Every cloud plan starts with a 7-day free trial and you can cancel anytime. If you prefer full control, the open source version is free to self-host with Docker.

Which Instagram formats can postqueen schedule?

Feed photos and videos, carousels, reels and stories. You compose once, preview the result, and postqueen publishes each piece in its 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.