Gemini + Instagram
Post to Instagram from Gemini
Ask Gemini to write and schedule your Instagram posts. BrokenPost connects the two, follows Instagram's rules and posts at the time you pick.
How to connect Gemini to Instagram
- 1
Connect Instagram in BrokenPost. Connect an Instagram business or creator account, either through its Facebook Page or with Instagram login.
- 2
In BrokenPost, open Plugins and copy your MCP URL.
- 3
Add the config below to ~/.gemini/settings.json.
- 4
Start Gemini CLI and run /mcp auth brokenpost to sign in.
- 5
Ask Gemini to schedule a post.
{
"mcpServers": {
"brokenpost": { "url": "<MCP_URL>" }
}
}Prefer another way? See every way to connect Gemini.
What to ask Gemini
Type these in Gemini CLI. Change the details to fit your posts.
- “Post these 5 photos as an Instagram carousel on Friday at 6pm with a short caption.”
- “Schedule this video as an Instagram Reel tomorrow at 7pm and tag @partnerbrand as a collaborator.”
- “Share this picture to my Instagram story on Saturday morning.”
- “Write an Instagram post about the file I just shared and schedule it for tomorrow at 9am.”
- “What Instagram posts do I have scheduled for next week?”
What happens next
- 1
You ask in Gemini CLI, in plain words.
- 2
Gemini lists the channels you connected in BrokenPost and picks your Instagram account.
- 3
It reads Instagram's rules and settings from BrokenPost, so the post fits Instagram's limits before it is written.
- 4
If you shared a picture, a video or a link to one, it uploads it to your media library.
- 5
It creates the post as scheduled, as a draft, or to go out now, and gives you a preview link.
- 6
At the set time BrokenPost publishes it to Instagram and it shows on your calendar.
Instagram limits Gemini follows
Gemini reads these rules from BrokenPost before it writes, so the post fits the first time.
| Characters | 2,200 characters |
|---|---|
| Media | At least 1 picture or video, up to 10 in a carousel |
| Carousel | Up to 10 pictures or videos |
| Stories | Pictures or videos, each one becomes its own story |
| Trial Reels | 1 video only |
| Text-only posts | Not allowed |
Instagram settings you can ask for
Say them in plain words, like "post or story", and Gemini sets them on the post.
- Post or story
- Collaborators to tag
- Trial Reel and how it graduates
- Music for a single video Reel
If Instagram rejects a post
Gemini sees the same message and can fix the post for you.
| What you see | How to fix it |
|---|---|
| Aspect ratio not supported, must be between 4:5 to 1.91:1 | Crop the picture to a size between portrait 4:5 and landscape 1.91:1. Square always works. |
| Instagram carousel should have between 2 and 10 media attachments | A carousel needs 2 to 10 items. Remove extras or post them as a second carousel. |
| Collaborators are not allowed for carousel | Instagram only takes collaborators on single posts and Reels. Remove them or post one item. |
| Caption is too long | Instagram allows 2,200 characters. Shorten the caption or move details to the first comment. |
| Image is too large | Export the picture at a smaller size and upload it again. |
| Should have at least one media | Instagram never takes text-only posts. Add a picture or video. |
Good to know
- Every Instagram post needs at least one picture or video.
- A carousel can hold up to 10 items.
- Music can only be added to a single video Reel, not to Stories.
- Gemini only posts when you ask. Ask for a draft to check the post in BrokenPost first.
Questions people ask
Can Gemini post to Instagram directly?
Yes, through BrokenPost. Connect Instagram in BrokenPost, connect BrokenPost to Gemini, and Gemini can schedule, draft or publish Instagram posts.
Does Gemini know the Instagram limits?
Yes. Gemini reads Instagram's rules from BrokenPost before it writes: 2,200 characters and at least 1 picture or video, up to 10 in a carousel. BrokenPost checks again before it posts.
Can Gemini schedule Instagram posts for later?
Yes. Give a day and time, like "Friday at 6pm", and the post goes out then. Ask for a draft if you want to check it first.
Is it free?
Gemini with BrokenPost works on every plan. The Free plan includes 1 account on every app and 20 posts a month. Paid plans start at $19 a month with unlimited posts.
What if I don't have a picture or video?
Instagram needs media on every post. Gemini can upload one from a link, use your media library, or make a new picture or video for you.
Which Instagram settings can Gemini set?
Post or story; Collaborators to tag; Trial Reel and how it graduates; Music for a single video Reel.
Can Gemini post an Instagram thread or comments?
Yes. Ask for a thread or a first comment and BrokenPost posts each part as a reply, right after the first one.
Do I need an Instagram business account?
You need a business or creator account. You can connect it through a Facebook Page or straight with Instagram login.
Can I schedule Instagram Stories?
Yes. Set the post type to story. Each picture or video you add is posted as its own story.
More apps with Gemini
Post to Instagram with other AI
Write once. Post everywhere.
Start free with BrokenPost. Connect your apps and your AI in a few minutes.