Coding agent by OpenAI
Schedule social media posts with Codex
Connect BrokenPost to OpenAI Codex and schedule launch posts and release notes from your terminal.
How do I connect Codex to BrokenPost?
There are 2 ways. Pick the one that fits you.
Add the MCP server to Codex
- 1
In BrokenPost, open Plugins and copy your MCP URL.
- 2
Add the lines below to ~/.codex/config.toml.
- 3
Run codex mcp login brokenpost and sign in.
- 4
Ask Codex to schedule a post.
# ~/.codex/config.toml
[mcp_servers.brokenpost]
url = "<MCP_URL>"Use the BrokenPost CLI and agent skill
- 1
In BrokenPost, open Plugins, then CLI & AI Skills, and copy the install commands.
- 2
Run them in your terminal. They install the CLI and the BrokenPost skill for your agent.
- 3
Set your BrokenPost API key as an environment variable.
- 4
Ask Codex to schedule a post. It calls the CLI for you.
What can you ask Codex?
Type these in Codex. Codex writes the post, BrokenPost schedules it.
- “Write release notes for the v1.8 tag and post them to Slack #releases and Discord at 3pm.”
- “Draft a LinkedIn post about the performance fix in the last commit and save it as a draft.”
- “Schedule a post on X and Bluesky when this deploy finishes: "v1.8 is live".”
What happens when you ask Codex to post
- 1
You ask in Codex, in plain words.
- 2
Codex lists the channels you connected in BrokenPost and picks the right ones.
- 3
It reads each app's rules and settings from BrokenPost, so the post fits every limit before it is written.
- 4
If you shared a picture, a video or a link to one, it uploads it to your media library.
- 5
It creates the post as scheduled, as a draft, or to go out now, and gives you a preview link.
- 6
At the set time BrokenPost publishes it and it shows on your calendar.
What Codex can do in BrokenPost
Schedule, draft or post now
Create a post for one app or many, for a set time, as a draft, or right away.
See your calendar
List what is scheduled, published, drafted or failed between any two dates.
Fix or remove posts
Change the settings of a post that has not gone out yet, or delete a post with its comments.
Use the right settings
Read each app's rules and settings, like subreddits, boards, privacy or flair, before posting.
Add your media
Upload a picture or video from a link to your media library.
Make pictures and videos
Generate a picture or a short video for a post.
Cut long videos into clips
Turn a long YouTube video into short vertical clips with captions, saved as drafts.
Work across brands
List your brands and post to the right channels for each one.
Where Codex shines
- Release posts from tags and commits
- Scripted, repeatable posting
- Team updates in Slack and Discord
Which apps can Codex post to?
Every app you connect in BrokenPost. Pick one to see its limits and how to post to it from Codex.
If something goes wrong
| Problem | Fix |
|---|---|
| BrokenPost tools don't show up | Restart Codex after adding BrokenPost, or start a new chat, and check that the server is turned on. |
| It keeps asking me to sign in | Remove BrokenPost from Codex, add it again and sign in once more. |
| It says a channel is not connected | Connect the app in BrokenPost first. Codex can only post to channels connected there. |
| A post failed | Ask Codex "why did my last post fail?" It can read the error from BrokenPost and help you fix the post. |
| I used an API key and it stopped working | If you rotated your key in BrokenPost, put the new one in Codex's config. |
What it costs to use Codex with BrokenPost
AI agents work on every plan, including Free.
| Free | Free · 1 brand · 20 posts a month |
|---|---|
| Creator | $19/month or $12/month yearly · 3 brands · unlimited posts |
| Pro | $29/month or $19/month yearly · 10 brands · unlimited posts · +5 brands for $19/month |
| Team | $99/month or $49/month yearly · 25 brands · unlimited posts · +10 brands for $39/month |
Questions people ask
How do I connect Codex to BrokenPost?
In BrokenPost, open Plugins and copy your MCP URL. Add the lines below to ~/.codex/config.toml. Run codex mcp login brokenpost and sign in. Ask Codex to schedule a post.
Can Codex schedule posts to Instagram, TikTok and LinkedIn?
Yes. Once connected, Codex can post to every app you connected in BrokenPost: X, LinkedIn, Instagram, Facebook, TikTok, YouTube, Threads, Pinterest, Reddit, Bluesky and more.
Is it free to use Codex with BrokenPost?
Yes. AI agents work on every BrokenPost plan. The Free plan includes 1 account on every app and 20 posts a month. Paid plans start at $19 a month with unlimited posts.
Will Codex post without asking me?
Codex only acts when you ask. You can also ask for drafts and approve them in BrokenPost before anything goes live.
Does Codex know each app's rules?
Yes. Before it posts, Codex reads each app's limits and settings from BrokenPost, like character limits, media rules and required fields, and BrokenPost checks the post again before it goes out.
Can Codex add pictures and videos?
Yes. It can upload a picture or video from a link, use files from your media library, or make a new picture or video for the post.
Other AI agents
Write once. Post everywhere.
Start free with BrokenPost. Connect your apps and your AI in a few minutes.