Codex + Posteady

Turn commits into posts
with Codex

Connect Posteady to OpenAI Codex and it reads your git history, writes a post that fits each channel, and schedules it. Setup is one command and a browser sign-in.

  • codex mcp add opens the sign-in window right away
  • Writes channel-ready posts from git history and PR notes
  • Keep tone rules in AGENTS.md for consistent posts

Connect Posteady to Codex

When you add the server, Codex detects OAuth and opens a browser sign-in right away.

  1. 1

    Add the server

    Run the command below in your terminal. It's saved to ~/.codex/config.toml.

  2. 2

    Allow in your browser

    Sign in and click Allow in the Posteady approval window. The terminal shows that you're logged in.

  3. 3

    Ask Codex

    Start codex and ask: “Write a launch post from the commits since the last tag and schedule it for 9 a.m. tomorrow.”

Terminal
codex mcp add posteady --url https://www.posteady.com/api/mcp

If the sign-in window didn't open, or you need to sign in again, run codex mcp login posteady.

Posteady connects on the Creator plan or above, including during the free trial.

Read the full Codex guide with screenshots

Things to ask Codex

Paste these in once you're connected. Naming the account, time, and channel makes results more precise.

  • Collect the titles of PRs merged this week and schedule a LinkedIn weekly update for Friday at 5 p.m.

  • Rewrite this announcement for Threads and X following the “Social tone” rules in AGENTS.md, then post it now: [your text]

  • Upload assets/launch.png and schedule it on Instagram as our launch image for noon tomorrow.

  • Show only next week's scheduled posts.

Put your posting rules in AGENTS.md

Codex reads your repo's AGENTS.md before it works. Write down your tone, hashtags, and per-channel length there, and every launch post follows the same rules.

  • The rules live in the repo, so teammates' Codex sessions write in the same voice.
  • Posts draw on what's in the repo, like git history and PR descriptions.
  • Ask for drafts first, and Codex schedules only after you approve.
AGENTS.md
## Social tone
- Friendly, plain English; at most one emoji per post
- X: no links in the first post (put them in the second)
- LinkedIn: three short paragraphs, three hashtags
- Schedule weekdays at 9 a.m. (America/New_York)

Example only — change the time, channels, and file names to fit your setup.

What you can do from Codex

Your agent calls Posteady's tools to post to your real accounts and read your history — across seven channels: Threads, Instagram, X, LinkedIn, TikTok, YouTube, and Facebook.

  • Publish or schedule

    Post to several channels at once, or schedule for later, in a single request. On X and Threads, several posts go out as a thread.

    publish_post · schedule_post

  • Performance reports

    Read views, likes, and comments for up to 100 posts from the last 90 days, then sum up what worked.

    list_posts

  • Make carousels

    Create a carousel from a topic, text, or link, then post or schedule the finished slides on Instagram as-is.

    create_carousel · get_carousel

  • Review and cancel schedules

    See everything that's scheduled and cancel what changed. For posts that take a while, like videos, check that publishing finished.

    list_scheduled_posts · cancel_scheduled_post · get_publish_status

  • Repost winners

    Reshare your best-performing posts on Threads and LinkedIn.

    repost_post

  • Accounts and workspaces

    Read your connected accounts and workspaces to pick where each post goes. Agencies with many clients just name the workspace.

    list_workspaces · list_accounts · list_media

What you need for Codex

Where it runs
Terminal (Codex CLI)
What you need
Codex CLI installed
How it connects
codex mcp add command (OAuth)
File uploads
Uploads local files to an upload URL, then posts
Mobile
No (desktop terminal)
Posteady
Posteady Creator plan or above (works during the free trial)

Your agent doesn't post on its own

Access opens only through Posteady sign-in, actions are confirmed before they post, and you can cut access anytime.

  • Sign in, no API keys

    You sign in to Posteady in an OAuth approval window and allow access. No passwords or keys go into the chat, and access tokens renew every hour.

  • Confirmation before posting

    Posteady marks tools with outside effects, like publishing. Apps such as ChatGPT and Claude ask you once more before running them.

  • Same permissions, revoke anytime

    Workspace roles and permissions still apply. Revoke access anytime under Connected AI apps in Posteady settings.

Posteady

FAQ

Still have questions? Feel free to reach out!

Contact us

Codex saves the Posteady server to ~/.codex/config.toml, detects that it uses OAuth, and opens the Posteady approval window in your browser. Sign in and click Allow; the terminal confirms you're logged in, and your codex sessions can use Posteady's tools.

Run codex mcp login posteady. If you can't open a browser there, add --no-browser to print the authorization URL, approve it on another device, and paste back the callback URL.

No. Connecting and posting work without it. If repeating your tone, hashtags, and channel lengths gets tedious, write them in AGENTS.md — Codex reads it before it starts.

Run codex mcp logout posteady to delete the stored credentials on this computer, and codex mcp remove posteady to remove it from your config. To revoke access entirely, remove Codex under Connected AI apps in Posteady settings.

Take back the time you spend on social marketing

No credit card required