PostNinja
Get started

OpenAI Codex + PostNinja

Schedule Social Media Posts with OpenAI Codex

Connect PostNinja to Codex and turn finished work into scheduled posts. Codex reads your key from an environment variable, so nothing secret ends up in your config.

  • 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 OpenAI Codex?

  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 OpenAI Codex

    Set the key in your shell, then add the server with one command:

    Terminal
    export POSTNINJA_API_KEY=pn_YOUR_KEY
codex mcp add postninja --url https://postninja.app/api/mcp --bearer-token-env-var POSTNINJA_API_KEY

    ~/.codex/config.toml

    Or in config.toml
    [mcp_servers.postninja]
url = "https://postninja.app/api/mcp"
bearer_token_env_var = "POSTNINJA_API_KEY"

    Replace pn_YOUR_KEY with a key from Settings → API.

    POSTNINJA_API_KEY must be set in the shell that starts Codex.

  3. 3

    Just ask

    OpenAI Codex finds the PostNinja tools on its own. Try:

    • “Write release notes for v2.3 from the git log and schedule a post about it on X and Threads at 10am.”
    • “Turn README.md's feature list into a 4-post X thread for Tuesday.”
    • “Did yesterday's posts go out?”

Tools

What can OpenAI Codex 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 OpenAI Codex can post to any of them, and PostNinja publishes at the time you set.

FAQ

OpenAI Codex and PostNinja questions

Does this work in ChatGPT too?

Yes. Add PostNinja to ChatGPT as an app and sign in; see the ChatGPT setup guide.

Does OpenAI Codex post without asking me?

That depends on OpenAI Codex'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 OpenAI Codex 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 OpenAI Codex run your social media.

Connect OpenAI Codex to PostNinja in a couple of minutes. Plans from $15 a month.

Choose your planLog in