# Post to Instagram from Gemini CLI

> Ask Gemini CLI for an Instagram post and your Brandiz.io studio makes it in your brand, from your website. Then it is scheduled on the Instagram account you connected, at the time you pick.

Web page: https://www.brandiz.io/agents/gemini-cli/instagram · Updated 2026-11-09

## Set up Gemini CLI

You need a Brandiz.io account with your business set up and your Instagram account connected under Channels. The address: https://www.brandiz.io/api/mcp

1. **Add the server**: Run the first command below. It goes in this project's .gemini/settings.json; add --scope user, as in the second, for every project.
2. **Sign in**: In Gemini CLI, type /mcp auth brandiz. Brandiz.io opens in your browser: sign in, check the business, tick Let it schedule and post for me if it may post for you, and tap Allow. It needs a browser, so it won't work on a machine without one.
3. **Check it**: gemini mcp list, or /mcp inside Gemini CLI, shows the server and whether it is connected.
4. **Ask**: Try: what should I post this week? Then: make a reel about our newest product and schedule it for Saturday.

## What to copy

**Add Brandiz.io**

```bash
gemini mcp add --transport http brandiz https://www.brandiz.io/api/mcp
```

**Or in every project**

```bash
gemini mcp add --scope user --transport http brandiz https://www.brandiz.io/api/mcp
```

**Or in settings.json**

```json
{
  "mcpServers": {
    "brandiz": {
      "httpUrl": "https://www.brandiz.io/api/mcp"
    }
  }
}
```

## What Gemini CLI can have made for Instagram

### Posters in your brand

Ask for a post and the studio designs it from your website, in your fonts and colours. On Instagram it goes out in the portrait 4:5 (1080 × 1350) size.

### Stories

The same design also comes in the story 9:16 (1080 × 1920) size, which goes out as a story on Instagram beside the post.

### Reels from your pictures

Ask for a reel and the studio makes it in 9:16 from your own pictures, with music, captions and a voice-over. It uses one reel from your package.

### Your own post

Hand Gemini CLI your photos (several make one post) or a video with your caption, and it goes out on Instagram when you say. That uses nothing from your package.

## Instagram's rules, as the studio follows them

The same rules the app checks before a post can go out.

| Rule | Instagram |
| --- | --- |
| Caption | Up to 2,200 characters |
| Before “more” | About the first 125 characters show |
| Hashtags | At most 5, specific to the post |
| Emoji | 2 at most |
| Feed size | portrait 4:5 (1080 × 1350) |
| Stories | The story 9:16 (1080 × 1920) size goes out as a story |
| Posts carry | pictures, videos |
| Carousels | Yes |
| Text-only posts | No: every post has a picture or video |

## From your ask to Instagram

1. **It reads your business**: Gemini CLI reads your brief, voice and facts first, so the post sounds like you and every number is one you confirmed.
2. **It adds the post**: It adds the words for the studio. They pass the same claims check as your own posts.
3. **The studio makes it**: Your studio designs the poster in your brand, or makes the reel, and its status says when it's ready.
4. **It schedules it on Instagram**: It picks the queue, a time or now. With your tick it goes out then; without it, it waits for your Approve.

## Asks to try on Instagram

Type them to Gemini CLI as you would ask a person.

- “Make a poster about our Friday offer and post it on Instagram at 6 pm.”
- “Make a reel about how we pack an order and schedule it for Instagram on Saturday morning.”
- “What's going out on Instagram this week, and is anything still waiting for my approval?”
- “How did our Instagram posts do this month? Plan next week around the best one.”
- “Post the photos in ./launch to Instagram as one post tonight at 8 pm, with a caption in our voice.”

## Or from the command line

Gemini CLI can run these too, once npx brandiz login has your API key.

**Your own post on Instagram, now**

```bash
npx brandiz channels
npx brandiz posts own photo.jpg --caption "..." --channels instagram --when now
```

## Questions

### Can Gemini CLI post to Instagram without me?

Only if you tick Let it schedule and post for me on the Allow screen when you sign in. Without it, the post is planned for the time Gemini CLI picked and waits for your Approve in Brandiz.io.

### Do I need to connect my Instagram account first?

Yes. Connect your Instagram account in Brandiz.io under Channels. Gemini CLI posts only to the accounts you connected, and it can't connect or disconnect them.

### What size does it make for Instagram?

Portrait 4:5 (1080 × 1350) for the feed, and the same design's 9:16 story size (1080 × 1920) goes out as a story.

### Does it use my package?

Reading, writing and scheduling don't. A poster the studio designs uses one post from your package the first time, and a reel uses one reel. Your own photos and videos use nothing.

## Sources

- [Gemini CLI docs: MCP servers with Gemini CLI](https://geminicli.com/docs/tools/mcp-server/), checked 2026-11-09

## Read next

- [Gemini CLI](https://www.brandiz.io/agents/gemini-cli)
- [Instagram](https://www.brandiz.io/platforms/instagram)
- [Facebook](https://www.brandiz.io/agents/gemini-cli/facebook)
