Postemi Agent MCP Server

Postemi CLI

Social media scheduling from the command line, or from your AI agent.

Postemi (https://postemi.com) is a social media scheduler, and this is its command-line tool. It uses the same public API as the web app: what you schedule here shows up in your Postemi calendar, and what you schedule there you can see here too.

Channels: 37 platforms and apps, including Facebook, Instagram, X, LinkedIn, TikTok, YouTube, Threads, Bluesky, Pinterest and Mastodon.

Plan: the CLI, the API and MCP need the Pro plan or higher (Pro, Creator or Team). Basic has no API access.

SKILL.md is the full command reference, written for AI agents. Show it to Claude, ChatGPT, Codex, OpenClaw or Hermes and they can use the whole CLI with no further explanation.

Install

npm install -g postemi
postemi --help

Node.js 18 or newer.

Sign in

postemi auth:login     # device flow: opens postemi.com/app/device in the browser
postemi auth:status    # checks the credential
postemi auth:logout    # deletes the stored credential

You approve the login in the browser while signed in to Postemi, and choose there which workspace and which channels the key may reach. The CLI stores it in ~/.postemi/credentials.json (mode 0600).

No account yet? Create one from the terminal:

postemi auth:signup --email anna@example.com    # e-mails a code, asks for it and for the terms
postemi auth:signup --email anna@example.com --code 123456 --accept-terms --workspace-name "Anna's Cafe"

The person must agree to https://postemi.com/terms and https://postemi.com/privacy first. An account made with postemi auth:signup has no free trial: next come postemi billing:plans and postemi billing:subscribe. Signing up at https://postemi.com/app/signup instead starts a 7-day free trial; then run postemi auth:login.

For a server, CI or an agent without a browser, use an API key from Settings, Developers in the web app:

export POSTEMI_API_KEY=your_api_key

Stored credentials from auth:login take precedence over POSTEMI_API_KEY.

Quick start

postemi auth:status
postemi integrations:list                        # your channels and their ids
postemi config:set timezone Europe/London        # once: how to read dates without an offset

IMG=$(postemi upload ./photo.jpg | jq -r '.path')
postemi posts:create -c "Hello from the terminal" -m "$IMG" \
  -s "2026-12-31 09:00" -i "<integration-id>"

Results are JSON on stdout; status lines and errors go to stderr, and every failure exits 1. Run postemi <command> --help for each command.

Agent skills (optional)

The CLI can install its skills into the coding agents on your machine (Claude Code ~/.claude/skills, Codex ~/.codex/skills or $CODEX_HOME/skills, Cursor ~/.cursor/skills, Grok Build ~/.grok/skills). The core postemi skill comes with any of them; the other two are optional:

postemi skills list                    # core, writing, growth: installed where
postemi skills add writing             # ideas, hooks, formatting, templates
postemi skills add growth              # niche, cadence, 30-day plan
postemi skills add all --agent claude --yes
postemi skills remove growth

After postemi auth:login on a terminal the CLI asks once whether you want the writing and the growth skill (default No) and remembers the answers in ~/.postemi/config.json. It never asks when an agent or a script runs it (no terminal, --json, or CI set); it prints one hint line instead, once. With several agents found it asks which; --agent and --yes skip that.

More

• SKILL.md: every command, flag and rule
• PROVIDER_SETTINGS.md: per-channel settings
• SUPPORTED_FILE_TYPES.md: the eight accepted media types
• examples/: ready --json payloads
• MCP server for chat clients: https://mcp.postemi.com/mcp
• Help: https://postemi.com/help, support: norbert@postemi.com
• Privacy: https://postemi.com/privacy, terms: https://postemi.com/terms

Plugins for AI agents

This repository also holds the Postemi plugins, in plugins/:

In Claude Code:

claude plugin marketplace add norbertlevente/postemi-agent
claude plugin install postemi@postemi-agent        # MCP server
claude plugin install postemi-cli@postemi-agent    # CLI skill

The skill on its own (for OpenClaw and other agents) is skills/postemi/SKILL.md.

Writing and growth skills

Three more skills help the agent write the posts, not only schedule them:

claude plugin install postemi-growth@postemi-agent   # the optional growth plugin

With the CLI, writing and growth are both optional; see below.

Development

pnpm install
pnpm build        # dist/index.js
pnpm test         # type check, build, unit tests (test/), scripts/check.mjs (manifests, skill copies, no other-brand text)
node dist/index.js --help

pnpm sync:templates ../postemi/src/lib/app/templates   # regenerate skills/postemi-templates/reference from the web app
pnpm sync:skills                                       # copy writing and templates into the main plugins, growth into postemi-growth

Release steps: PUBLISHING.md. Changes: CHANGELOG.md.

License: AGPL-3.0, see LICENSE. Source: https://github.com/norbertlevente/postemi-agent