
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.jsonin the current project only. - The command writes
"url"with"type": "http", which works.httpUrlis the older key; a guide that callsurlwrong 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
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.