Connect Codex to PosteAhora, step by step
Five steps, about two minutes, in a terminal. The Codex app and the IDE extension pick up the same server.
Before you start
You need a PosteAhora account with at least one network connected, and Codex installed and signed in. Nothing to install from us: the server runs on our side.
The connector URL is the same for every client: https://mcp.posteahora.com/mcp. It signs you in with your PosteAhora account — no API key to paste. Networks are connected in Connections first; the assistant can only reach what is connected there.
1. Add the server
Run this in a terminal. Codex saves a posteahora entry with our URL to ~/.codex/config.toml.
codex mcp add posteahora --url https://mcp.posteahora.com/mcp
Prefer editing the file? Add [mcp_servers.posteahora] with url = "https://mcp.posteahora.com/mcp" to ~/.codex/config.toml, then run codex mcp login posteahora.
2. Sign in with PosteAhora
Codex opens a PosteAhora page in your browser. Sign in there if you are not already.
Nothing to paste: no client ID, secret or API key. Codex registers itself with our server.
3. Pick a workspace and approve
The page shows who you are signed in as and what Codex will be able to do — read and manage your posts, ideas, connected accounts and analytics. Choose the workspace and click Approve, then go back to the terminal.
The connection is fixed to that workspace. To work in another one, run codex mcp login posteahora and pick it there.
4. Ask Codex
Start a session and describe the post and when it should go out. codex mcp list shows the server if you want to check first.
Write a LinkedIn post about what changed in this release and schedule it for Tuesday at 9:00.
5. See it in your queue
Open Publish in PosteAhora: the post sits under Tuesday at 9:00, marked scheduled, editable until it goes out.
Where these steps come from
Not yet run by us. These steps follow the Codex documentation for MCP servers — codex mcp add with a URL, the OAuth login and config.toml — and were written on September 26, 2026. Codex already signs in to our server this way in production; we have not taken screenshots of the flow yet. When a command no longer matches, trust the Codex docs, and tell us. Source: Codex MCP docs.
FAQ
Can Codex post to social media on its own?
No. Codex can read and change your code and run commands, but it has no publishing rights on any social network. PosteAhora is the MCP server that gives it those: you connect Instagram, X, LinkedIn and the rest in PosteAhora once, and Codex publishes through those connections. It never sees the networks' passwords.
How do I add PosteAhora to Codex?
Run codex mcp add posteahora --url https://mcp.posteahora.com/mcp. Codex writes the entry to ~/.codex/config.toml and signs you in straight away in the browser. To sign in again later, run codex mcp login posteahora.
Does it work in the Codex app and the IDE extension?
Yes. The CLI, the Codex app and the IDE extension share the MCP servers in ~/.codex/config.toml, so a server added from the terminal is there in the others too.
Do I need an API key?
No. Codex signs you in with OAuth and you pick the workspace it may use. On a machine without a browser, codex mcp login posteahora --no-browser prints the sign-in link instead; an API key is only for CI, added with --bearer-token-env-var so it stays in an environment variable, not in config.toml.
Can a release script run it?
Yes. codex exec "…" runs the agent without an interactive session, so a script can ask it to write and schedule the announcement after a release. On a CI runner, add the server with --bearer-token-env-var and keep your PosteAhora API key in that variable.
Can it attach a screenshot from my repo?
Yes. The server runs on our side and can't read your disk, so Codex asks it for an upload link and sends the file there itself, the way it runs any other command. A public URL works too.
Which workspace does Codex post to?
The one you approve when you sign in. The connection is fixed to it; to post from another workspace, sign in again and pick that one.
What does it cost?
Codex is billed by OpenAI. On our side there is a 7-day trial for $0 with a card on file, then a flat monthly or yearly price by plan, with the MCP server included. Every plan has unlimited posts; what varies is how many social accounts you can connect.
Marketing version of this guide, with what the integration is for: /mcp/codex. Every client that speaks MCP is listed on /mcp.