Skip to main content
Gemini CLI is Google’s AI agent for the terminal. Add PostQueen with one command and Gemini CLI can turn release notes into posts, schedule them and report how your published posts did.
A sample Gemini CLI terminal session with PostQueen connected: a request for posts, the PostQueen tools it used, and the reply

Before you start

  • Plans: free with a personal Google account, up to 60 requests a minute and 1,000 a day.
  • Platforms: the terminal on macOS 15+, Windows 11 24H2+ and Ubuntu 20.04+, with Node 20 or later.
  • A PostQueen API key. A workspace admin copies it, or the ready-made address, from Connections.
Where the API key is: in the app, open Connections > API Keys. Only a workspace Admin or Super Admin can reveal or rotate it; other members see it masked. A workspace has one key, and each agent card on Connections shows your MCP address with the key already filled in.

Connect Gemini CLI

1

Add PostQueen

Run this in your terminal, with your key in place of YOUR_API_KEY:
--scope user writes ~/.gemini/settings.json, so every folder can use PostQueen.
2

Check the tools

Start Gemini CLI and type /mcp. PostQueen is listed with its tools.

Check that it works

Ask Gemini CLI: “List my PostQueen channels.” It calls PostQueen and answers with the channels you connected.

Good to know

  • Use the key address, not the sign-in. Since v0.60.0, Gemini CLI refuses PostQueen’s sign-in, so the sign-in address does not work here.
  • Without --scope user, the command writes .gemini/settings.json in the current project only.
  • The command writes "url" with "type": "http", which works. httpUrl is the older key; a guide that calls url wrong is out of date.
  • Gemini CLI can run the command for you if you allow it.
  • Ask for drafts when you want to check first. A draft waits on your PostQueen calendar, and nothing publishes until you schedule it.
  • What it cannot do over MCP: delete a post, or change a post’s text or time. Do that on the calendar in the app. The MCP tools lists what it can do.

Other ways to connect

To keep the key out of the address, send it as a header:

Try this first

The draft appears on your PostQueen calendar, ready for you to check and schedule. Prompts to try has more.

Troubleshooting

More fixes are on Troubleshooting agents.

Next steps

Every agent

Which agents can post to PostQueen, and how each one connects.

The MCP tools

What each of the 22 tools does, and what an agent cannot do.

Prompts and tool calls

The order an agent calls the tools in, with prompts that work.

Troubleshooting agents

What to do when a connection or a command fails.
Last modified on September 24, 2026