PlatPostPricingGuidesReviewsSign in

How do you connect Gemini CLI to PlatPost?

By Guy Hamilton, founder of PlatPost. Last updated .

The short answer

Make an agent key on the Agents page in PlatPost, then add PlatPost to Gemini CLI as an MCP server with that key. A new key lets Gemini CLI read your Business Brain and write drafts for you to approve. Gemini CLI schedules or posts only if you turn those rights on for its key.

Key facts

Works with
Gemini CLI.
How it connects
MCP over Streamable HTTP, at https://platpost.com/api/mcp, with your agent key in the Authorization header.
A new key can
Read the Business Brain, channels and posts, and write drafts for you to approve.
Off until you turn it on
Schedule posts, and publish posts at once.
Daily caps for each workspace
100 agent drafts and 20 agent posts in 24 hours.
Keys
Up to 10 keys a workspace. PlatPost shows a key once and stores only a one-way hash of it.

What can Gemini CLI do in PlatPost?

Gemini CLI is a command-line AI agent that reads MCP servers from its settings file.

PlatPost gives it a small set of tools through MCP, and each tool does one job.

  • Read your Business Brain: what you sell, who your customer is, your voice and your goal.
  • List your connected channels, so it knows where you post.
  • Read your recent posts with their status, text, schedule and live link, so it can match how you write.
  • Write a post as a draft. You review it in PlatPost as you would your own.
  • Upload an image, a GIF, a video or music that it made with its own tools. The file appears in the composer under From your agent.
  • Send you a message in the agent chat on every page, and read your replies.
  • With the schedule right on, schedule a post for a time up to one year ahead. With the publish right on, post at once.

How do I connect Gemini CLI to PlatPost?

Add to ~/.gemini/settings.json. Gemini CLI fills in $PLATPOST_KEY from the environment.

  1. Open the Agents page in PlatPost and make a key. Leave schedule and publish off for now.
  2. Copy the key. PlatPost shows it once.
  3. Put the key in the environment variable PLATPOST_KEY on your computer. On Windows PowerShell, the variable is $env:PLATPOST_KEY.
  4. Add the setup below in the place this section names.
  5. Ask Gemini CLI: "Read my PlatPost Business Brain and draft three posts about this week."
{
  "mcpServers": {
    "platpost": {
      "httpUrl": "https://platpost.com/api/mcp",
      "headers": { "Authorization": "Bearer $PLATPOST_KEY" }
    }
  }
}

Can Gemini CLI post without my approval?

Not with a new key. A new key can read and write drafts only, and every draft waits for you in PlatPost.

You can turn on two more rights for one key: schedule posts, and publish posts at once. Each right is a separate choice, because an agent that posts skips your approval. On the Free plan, Gemini CLI can read and draft, but it cannot schedule or publish until you choose a plan.

Is it safe to give Gemini CLI a PlatPost key?

An agent runs in a loop and does not get tired, so every limit is a number in the code.

  • PlatPost stores only a one-way hash of the key. Nobody can read the key back, PlatPost included.
  • Gemini CLI acts only in your own workspace. It cannot see another account.
  • The tools have no file, code, database or shell access, and nothing the agent sends runs as code.
  • A workspace takes at most 100 agent drafts and 20 agent posts in 24 hours, so a runaway loop stops at a number.
  • You can remove a key on the Agents page at any time. The agent loses access at once.

What should I ask Gemini CLI to do?

An agent works best with one clear job. These requests use only the tools above.

  • "Read my PlatPost Business Brain and draft three posts about this week."
  • "Draft a YouTube community post and a LinkedIn post about our launch. Keep both as drafts."
  • "List my channels and tell me which ones I have not posted to this month."

What if Gemini CLI cannot connect?

Each line below names a case, and then what to do about it.

  • Gemini CLI says the key is missing. Set PLATPOST_KEY in the same terminal or app that runs it, then start it again.
  • Gemini CLI says the key is refused. The key was removed or copied wrong. Make a new key on the Agents page, because an old key cannot be shown again.
  • Gemini CLI cannot schedule a post. The key has no schedule right, or the workspace is on the Free plan.
  • Gemini CLI stops making drafts. The workspace reached 100 agent drafts in 24 hours. The count frees up as the day moves on.

Questions people ask

Where does the PlatPost setup go for Gemini CLI?
In ~/.gemini/settings.json, under mcpServers. Gemini CLI fills in $PLATPOST_KEY from your environment, so the key never sits in the file.
Does the Gemini web app connect too?
The Agents page has a Quick connect button for Gemini. It puts a setup prompt on your clipboard and opens Gemini. Read the prompt before you send it.
Does Gemini CLI need a paid PlatPost plan?
Not to read and draft. Gemini CLI can read your Business Brain and write drafts on any plan. Scheduling and publishing need a paid plan.
Does Gemini CLI write in my voice?
Gemini CLI can read your Business Brain and your recent posts before it writes, so its drafts can follow your voice. You still edit and approve every draft.
Can Gemini CLI see my passwords or my other accounts?
No. A key reaches only your own workspace, and the tools have no file, code, database or shell access.
How do I stop Gemini CLI?
Remove its key on the Agents page. The agent loses access at once, and the drafts it already wrote stay in PlatPost.
Does a post on X from Gemini CLI cost the same as my own?
Yes. A post on X that Gemini CLI schedules or publishes takes the same X price from your wallet as a post you make yourself.

Try it

A free account lets you look at every screen. It connects no channel and posts nothing. Paid plans start at $29.99 a month, before tax. The pricing page has every tier and every limit.

Get started

Read next