# Post to X from Gemini CLI

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

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

## Set up Gemini CLI

You need a Brandiz.io account with your business set up and your X 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 X

### Posters in your brand

Ask for a post and the studio designs it from your website, in your fonts and colours. On X it goes out in the square 1:1 (1080 × 1080) size.

### 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 X when you say. That uses nothing from your package.

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

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

| Rule | X |
| --- | --- |
| Caption | Up to 280 characters |
| Hashtags | At most 2, specific to the post |
| Emoji | One at most |
| Feed size | square 1:1 (1080 × 1080) |
| Posts carry | pictures, videos |
| Carousels | Yes |
| Text-only posts | Yes |

## From your ask to X

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 X**: 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 X

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

- “Write a short post for X about today's offer, have the studio make the picture, and post it now.”
- “Make a square poster with our new opening hours and post it on X at noon.”
- “Stop everything that's going to X this week.”
- “Which of our posts did best on X last month?”
- “Post ./chart.png to X at 5 pm with one line about what it shows.”

## Or from the command line

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

**Your own post on X, now**

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

## Questions

### Can Gemini CLI post to X 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 X account first?

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

### How long can a post for X be?

Up to 280 characters. The team writes up to 260 characters, so it fits with room to spare.

### 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)
- [X](https://www.brandiz.io/platforms/x)
- [Threads](https://www.brandiz.io/agents/gemini-cli/threads)
