PostNinja
Get started

Claude Desktop + PostNinja

Schedule Social Media Posts with Claude Desktop

Brainstorm with Claude, then tell it to schedule the result. With PostNinja connected, Claude can see your accounts, write a version for each platform, and put posts on your calendar without you leaving the chat.

  • Connect once with an API key
  • Draft, schedule and publish by asking
  • 7 platforms: X, Instagram, TikTok, Facebook and more
Get startedHow to connect

Setup

How do I connect PostNinja to Claude Desktop?

  1. 1

    Create an API key

    In PostNinja, go to Settings → API and create a key. It starts with pn_ and is shown once, so copy it somewhere safe.

  2. 2

    Add PostNinja to Claude Desktop

    Add PostNinja as a custom connector and sign in; no API key needed. This works in the desktop app and on claude.ai. Prefer an API key? Use the config file instead (second box).

    1. In Claude, open Customize → Connectors and click Add custom connector.
    2. Name it PostNinja and paste the server URL below.
    3. Click Add, then Connect. Log in to PostNinja and click Allow.
    Server URL
    https://postninja.app/api/mcp

    macOS: ~/Library/Application Support/Claude/ · Windows: %APPDATA%\Claude\

    Or with an API key: claude_desktop_config.json (Settings → Developer → Edit Config)
    {
  "mcpServers": {
    "postninja": {
      "command": "npx",
      "args": ["mcp-remote", "https://postninja.app/api/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer pn_YOUR_KEY" }
    }
  }
}

    Replace pn_YOUR_KEY with a key from Settings → API.

    The API key route uses the mcp-remote bridge, which needs Node.js 18 or newer. Quit Claude completely and reopen it after editing the file.

    The header is written without a space (Authorization:${AUTH_HEADER}) on purpose: it avoids a known bug with spaces in arguments on Windows.

  3. 3

    Just ask

    Claude Desktop finds the PostNinja tools on its own. Try:

    • “Write three Instagram captions for our autumn sale and schedule the best one for Saturday at 10am.”
    • “Plan next week's posts for all my accounts: one a day, mornings, different text for X.”
    • “Which of my posts failed this week, and why?”

Tools

What can Claude Desktop do with PostNinja?

Write and schedule

Drafts posts, gives each platform its own text, and schedules them for any date and time.

Threads and Stories

Builds multi-post X threads and posts photos or videos as Instagram Stories.

Check what's planned

Lists upcoming posts, drafts and what went out, with links to the live posts.

Fix and reschedule

Moves, edits or deletes drafts and scheduled posts when plans change.

Add images

Uploads images to attach to posts. Larger files and video go through the REST API.

Spot failures

Reads each account's status and error, so it can tell you what didn't go out and why.

One connection, seven platforms

Connect your accounts in PostNinja once. From then on Claude Desktop can post to any of them, and PostNinja publishes at the time you set.

FAQ

Claude Desktop and PostNinja questions

Do I need an API key?

No. The custom connector signs in with your PostNinja account. The config-file route with an API key is there for setups that can't use connectors.

Does this work on claude.ai in the browser?

Yes. Custom connectors you add on claude.ai or in the desktop app work in both. On Team and Enterprise, an owner adds connectors for the organization.

Does Claude Desktop post without asking me?

That depends on Claude Desktop's own settings; most ask before each tool call. If you'd rather review everything, ask it to save posts as drafts, then schedule them from the PostNinja calendar.

Is my API key safe?

PostNinja only stores a hash of each key and shows its first characters so you can tell keys apart. A key works for one workspace, and you can revoke it any time under Settings → API.

Which platforms can Claude Desktop post to?

Every account you've connected: X, Instagram, Threads, Facebook Pages, TikTok, YouTube Shorts and Pinterest.

Do posts scheduled by an AI agent cost extra?

No. They're ordinary posts on your plan. As always, X posts use credits (10 each, 80 with a link) because X charges for every post; other platforms are unlimited.

Works with other AI agents too

Let Claude Desktop run your social media.

Connect Claude Desktop to PostNinja in a couple of minutes. Plans from $15 a month.

Choose your planLog in