# Post to Pinterest from Gemini CLI

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

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

## Set up Gemini CLI

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

### Posters in your brand

Ask for a post and the studio designs it from your website, in your fonts and colours. On Pinterest it goes out in the story 9:16 (1080 × 1920) 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 a photo or a video with your caption, and it goes out on Pinterest when you say. That uses nothing from your package.

### A title on every post

Pinterest asks for a title. The studio writes one, and Gemini CLI can change it.

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

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

| Rule | Pinterest |
| --- | --- |
| Caption | Up to 500 characters |
| Before “more” | About the first 50 characters show |
| Hashtags | At most 5, specific to the post |
| Emoji | One at most |
| Feed size | story 9:16 (1080 × 1920) |
| Posts carry | pictures, videos |
| Carousels | One picture or video a post |
| Text-only posts | No: every post has a picture or video |
| Title | Every post gets its own title |

## From your ask to Pinterest

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

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

- “Make a poster of our new arrivals and pin it on Pinterest on Saturday.”
- “Give tomorrow's pin a title with the words people search for.”
- “Make a reel of our best-selling product and pin it next week.”
- “What's planned for Pinterest next week?”
- “Pin ./product.jpg now with a short description.”

## Or from the command line

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

**Your own post on Pinterest, now**

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

## Questions

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

Yes. Connect your Pinterest 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 are the pins?

The tall 9:16 size (1080 × 1920), each with a title for search and a short description.

### 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)
- [Pinterest](https://www.brandiz.io/platforms/pinterest)
- [Instagram](https://www.brandiz.io/agents/gemini-cli/instagram)
