On airGemini CLI · Threads

Post to Threads from Gemini CLI.

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

01 Step by step

Set up Gemini CLI

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

02 Copy and paste

What to copy

Add Brandiz.io
gemini mcp add --transport http brandiz https://www.brandiz.io/api/mcp
Or in every project
gemini mcp add --scope user --transport http brandiz https://www.brandiz.io/api/mcp
Or in settings.json
{
  "mcpServers": {
    "brandiz": {
      "httpUrl": "https://www.brandiz.io/api/mcp"
    }
  }
}

03 In short

What Gemini CLI can have made for Threads

Posters in your brand

Ask for a post and the studio designs it from your website, in your fonts and colours. On Threads it goes out in the portrait 4:5 (1080 × 1350) 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 Threads when you say. That uses nothing from your package.

04 Side by side

Threads' rules, as the studio follows them

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

RuleThreads
CaptionUp to 500 characters
HashtagsOne, specific to the post
Emoji2 at most
Feed sizeportrait 4:5 (1080 × 1350)
Posts carrypictures, videos
CarouselsYes
Text-only postsYes

05 Step by step

From your ask to Threads

  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 Threads

    It picks the queue, a time or now. With your tick it goes out then; without it, it waits for your Approve.

06 Checklist

Asks to try on Threads

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

  • “Write a Threads post asking our customers which flavour we should bring back, with the studio's poster.”
  • “Queue the poster you made yesterday on Threads and Instagram.”
  • “How did our Threads posts do this month?”
  • “Is anything for Threads still waiting for my approval?”
  • “Post ./behind-the-scenes.jpg to Threads now with one hashtag.”

07 Copy and paste

Or from the command line

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

Your own post on Threads, now
npx brandiz channels
npx brandiz posts own photo.jpg --caption "..." --channels threads --when now

08 Asked often

Questions

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

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

How many hashtags go on Threads?

One. Threads lets a post carry one tag, so the most specific one is used.

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.

Your first posts are one link away.

Sign up and your first 3 posters are free, made from your website, with no card needed.

Or try the free brand read first.