The postozo command line tool

Install

You need Node.js 20 or newer. Then run:

npm install -g https://postozo.com/downloads/postozo-cli.tgz

The package is postozo-cli 0.1.0 (6 KB, no dependencies). It adds the postozo command. Check it with postozo version. To update, run the install command again. To remove it: npm uninstall -g postozo-cli. If npm says you have no permission, use a Node version manager, or set an npm prefix in your home folder.

Sign in

postozo auth:login

The CLI shows a link and a code like GRGG-WWDV, and opens the link in your browser. Sign in to Postozo if needed, check that the code matches and press Allow. The CLI waits (it checks every 3 seconds, for up to 10 minutes) and then saves a pz_cli_ token. The token acts as you, with your role in the workspace you were signed in to. It shows in Settings, Approved Apps as "Command line", where you can revoke it.

On a server with no browser, add --no-browser and open the link on another device. For your own server: postozo auth:login --url https://your-server.

Environment variables

export POSTOZO_API_KEY=pz_live_YOUR_KEY
postozo posts:create -c "Release 2.4 is out" -i CHANNEL_ID -t now

Commands

Examples

postozo auth:login
postozo auth:status
postozo auth:logout
postozo integrations:list
postozo integrations:groups
postozo integrations:settings de53f029-255d-4104-b090-974efcca2c86
postozo integrations:trigger PINTEREST_CHANNEL_ID boards -d '{}'
postozo posts:create -c "Our autumn menu is here" -c "Book a table" -i de53f029-255d-4104-b090-974efcca2c86 -s 2026-10-01T09:30:00+05:30 -d 5
postozo posts:list --startDate 2026-10-01T00:00:00Z
postozo posts:get 98c49d36-7dfd-439b-a857-e9a8e7e3f4a2
postozo posts:delete 98c49d36-7dfd-439b-a857-e9a8e7e3f4a2
postozo posts:retry 98c49d36-7dfd-439b-a857-e9a8e7e3f4a2
postozo posts:status 98c49d36-7dfd-439b-a857-e9a8e7e3f4a2 -s draft
postozo posts:settings 5001b946-c142-4ab7-b376-188c71272521 --settings '{"title":"My video"}'
postozo posts:missing 5001b946-c142-4ab7-b376-188c71272521
postozo posts:connect 5001b946-c142-4ab7-b376-188c71272521 --release-id 1839267162345
postozo analytics:platform de53f029-255d-4104-b090-974efcca2c86 --days 30
postozo analytics:post 5001b946-c142-4ab7-b376-188c71272521
postozo upload ./photo.jpg
postozo mcp
postozo version

A post with a picture on 2 channels, published now, with a first comment 2 minutes later:

postozo posts:create -c "New opening hours from Monday" -m ./hours.jpg -c "Questions? Reply here." \
  -i de53f029-255d-4104-b090-974efcca2c86,f451da5e-2cd3-4674-bbbb-dc6bc5e12b55 -t now -d 2

A whole body from a file (the same body as POST /posts):

postozo posts:create -j post.json

Network settings for every channel, or per channel id:

postozo posts:create -c "Watch our new video" -m ./video.mp4 -i YOUTUBE_CHANNEL_ID -t now \
  --settings '{"title":"Autumn menu","visibility":"Public"}'

JSON output

Lists print as a table. Add --json at the end of any command to get the raw JSON answer of the API, for scripts and jq:

postozo integrations:list --json | jq -r '.[] | select(.identifier=="linkedin-page") | .id'

Put --json last: an option followed by a word takes that word as its value.

Exit codes

$ postozo posts:create -c "x" -i CHANNEL_ID
Error: Add a date with -s 2026-10-01T09:30:00Z, or use -t now or -t draft
$ echo $?
1

postozo mcp for Claude Desktop

postozo mcp runs a local MCP server over standard input and output. It passes every message to https://app.postozo.com/mcp with your sign-in, so the AI gets the same tools and 2 prompts as the remote server. Sign in first with postozo auth:login, then add this to Claude Desktop's claude_desktop_config.json:

{
  "mcpServers": {
    "postozo": {
      "command": "postozo",
      "args": [
        "mcp"
      ]
    }
  }
}

Or use a key instead of the sign-in:

{
  "mcpServers": {
    "postozo": {
      "command": "postozo",
      "args": [
        "mcp"
      ],
      "env": {
        "POSTOZO_API_KEY": "pz_live_YOUR_KEY"
      }
    }
  }
}

If the app cannot find postozo, give the full path that which postozo prints. Claude Desktop also supports the remote server directly; see the Claude guide.

In CI

# GitHub Actions step
- run: npm install -g https://postozo.com/downloads/postozo-cli.tgz
- run: postozo posts:create -c "Version ${{ github.ref_name }} is out" -i ${{ vars.POSTOZO_CHANNEL }} -t now
  env:
    POSTOZO_API_KEY: ${{ secrets.POSTOZO_API_KEY }}

Use -t draft or -t review when a person should check the post first. The API guide explains limits and errors.