PostQueen CLI

postqueen is the command line for PostQueen. It creates, lists, changes and deletes posts, uploads images and videos, and reads analytics, from a terminal, a script, a scheduled job or an AI agent. It calls the PostQueen API with your API key, and every post it makes lands on the same calendar as the posts you write in the app. These pages describe postqueen 2.0.28. Run postqueen --version to see yours.

Claude Code runs postqueen integrations:list, then postqueen posts:create for X and LinkedIn, and reports the post as scheduled for 9:00 tomorrow

Before you start

Node.js 20.19 or newer. On Node.js 22, use 22.12 or newer.
A PostQueen workspace on a trial or a paid plan, with at least one connected channel.
The API key. Only a workspace Admin or Super Admin can reveal it.

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.

Install and set the key

Install the CLI

npm install -g postqueen

pnpm install -g postqueen

postqueen auth:login

Your browser opens PostQueen. A workspace Admin or Super Admin approves the CLI there, and the CLI saves its own token in ~/.postqueen/credentials.json. If PostQueen asks you to sign in first, it brings you back to the approval page afterwards.

Check it

postqueen auth:status

🔐 Authentication method: OAuth2
📡 API URL: https://api.postqueen.ai
🔑 Token: pos_a1b2...
🏢 Organization: 2f6c1d0e-...
📁 Credentials file: /Users/you/.postqueen/credentials.json

🔄 Verifying credentials...
✅ Credentials are valid. 3 integration(s) connected.

The sign-in link works in a browser on the same computer as the CLI. On a machine with no browser, such as a server, set the API key instead: export POSTQUEEN_API_KEY=your_api_key, with the key from Connections > API Keys. If you run PostQueen on your own server, also point POSTQUEEN_API_URL at your backend: see the key.

Schedule a first post

Find the channel ID

postqueen integrations:list

🔌 Connected Integrations:
[
  {
    "id": "cmf1abc2d0001",
    "name": "PostQueen Bakery",
    "identifier": "bluesky",
    "picture": "https://...",
    "disabled": false,
    "profile": "postqueenbakery.bsky.social"
  }
]

identifier is the network. Copy the id of the channel you want.

Create the post

postqueen posts:create \
  -c "Our spring menu is live. Come by this weekend." \
  -s "2026-10-01T09:00:00Z" \
  -i "cmf1abc2d0001"

✅ Post created successfully!
[
  {
    "postId": "cmf1xyz9k0042",
    "integration": "cmf1abc2d0001"
  }
]

-s is the publish time in ISO 8601 and is required. Add -t draft to save a draft instead.

See it on the calendar

The post is on your calendar in the app, and in postqueen posts:list.

Some networks need settings of their own before they accept a post. WordPress, for example, needs a title and a post type. postqueen integrations:settings <id> shows what a channel needs, and examples by network has a working command for each.

Read the output

Most commands print one status line, then the result as JSON. Drop the first line before you parse it:

postqueen integrations:list | tail -n +2 | jq -r '.[] | "\(.identifier)\t\(.id)"'

posts:missing prints JSON only, and posts:delete prints only a confirmation line. When a command fails, the message goes to stderr and the command exits with code 1. That includes a misspelled command or flag: ❌ Unknown command: post:create. Run "postqueen --help" for usage. See when a command fails.

Use it from an AI agent

An agent that runs shell commands, such as OpenClaw, Hermes Agent, Claude Code, Cursor, Gemini CLI or Grok Build, can drive the CLI. Install the postqueen skill so it knows the commands and the rules:

npx skills add GkhanKINAY/postqueen-agent

Set POSTQUEEN_API_KEY where the agent’s commands run, which is not always your own terminal.

CLI or MCP?

Pick	When
MCP	The agent supports MCP. Nothing to install. Codex should use MCP: its sandbox asks before every command that uses the network
CLI	The agent runs commands, or you are writing a script, a scheduled job or a CI step. The CLI can also delete posts, move them between draft and scheduled, and read channel numbers, which MCP cannot do yet, and it uploads files from disk in any agent

The full comparison is on AI agents.

Next steps

Posts and channels

Channels, settings, threads, drafts, campaign files and deleting.

Upload media

Images and videos, and waiting for a video to be ready.

Command reference

Every command and flag, and the API route each one calls.

Troubleshooting agents

What each error means and how to fix it.

Start here

Assistants and bots

Coding agents

Editors and more

MCP reference

CLI reference

Troubleshooting

Before you start

Install and set the key

Schedule a first post

Read the output

Use it from an AI agent

CLI or MCP?

Next steps

Posts and channels

Upload media

Command reference

Troubleshooting agents

​Before you start

​Install and set the key

​Schedule a first post

​Read the output

​Use it from an AI agent

​CLI or MCP?

​Next steps

Posts and channels

Upload media

Command reference

Troubleshooting agents

Before you start

Install and set the key

Schedule a first post

Read the output

Use it from an AI agent

CLI or MCP?

Next steps