Schedule social media posts with Claude Code

How to connect Postozo to Claude Code

You need a Postozo account with at least 1 connected channel. Claude Code connects to Postozo's MCP server at https://app.postozo.com/mcp using OAuth sign-in or an API key header.

Option 1: sign in with OAuth. Run:

claude mcp add --transport http postozo https://app.postozo.com/mcp

Then start Claude Code, type /mcp, pick postozo (it shows "Needs authentication") and sign in to Postozo in the browser. Tokens refresh on their own.

Option 2: use your API key. In Postozo, open Settings, Developers and copy your API key. It starts with pz_live_. Treat it like a password. Then run:

claude mcp add --transport http postozo https://app.postozo.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Scope. Add --scope user to use Postozo in every project, or --scope project to write a shared .mcp.json in the project. The default (local) is this project, for you only. For a shared file, keep the key in an environment variable:

{
  "mcpServers": {
    "postozo": {
      "type": "http",
      "url": "https://app.postozo.com/mcp",
      "headers": { "Authorization": "Bearer ${POSTOZO_API_KEY}" }
    }
  }
}

Check it works

Run /mcp and check that postozo is connected, then ask: "List my Postozo channels."

What Claude Code can do with Postozo

Postozo gives Claude Code 20 tools. A normal flow is: list your channels, read the rules of each network, check the post, find a free slot, then schedule it once you say yes.

The server also offers 2 ready prompts: plan_week (plan 5 posts for the next 7 days about a topic) and repurpose (turn a link or text into 1 post per channel).

Example prompts

• "Read CHANGELOG.md and write a LinkedIn post and an X thread about the latest release. Show me both before scheduling."
• "Schedule the release announcement for tomorrow at 10:00 India time on all my channels, using find_free_slot if 10:00 is taken."
• "Check this draft against the rules of every channel and tell me what to fix."
• "List every post that failed this week and show the error and fix for each."
• "Upload docs/screenshot.png from its public URL and add it to the LinkedIn post."
• "Save 3 drafts about this pull request for the Discord and Slack channels."

Safety and control

• 14 of the 20 tools only read. The 6 that change data (schedule_post, change_post_date, retry_post, delete_post, upload_media_from_url and generate_image) are marked as write tools, so Claude Code can ask you before it runs them.
• The server tells the AI to confirm the text, channels and time with you before it schedules or publishes.
• Ask for drafts ("save as drafts") or for client review ("send for approval") when you want a human to check first.
• A post is never sent twice. If Postozo cannot confirm a post went live, it marks it "could not confirm" instead of retrying on its own.
• Remove access any time in Postozo under Settings, Approved Apps, or by creating a new API key.

Sources

Setup steps checked on 29 September 2026 against: code.claude.com/docs/en/mcp. Claude Code is a trademark of its owner. Postozo is not affiliated with it. Menus change; if a step looks different, follow the linked docs.