Breakreach
LoginRegister
Codex · MCP server

Schedule social media from Codex.A week of posts, one task.

Run codex mcp add and sign in in your browser, and OpenAI's Codex can schedule posts on Instagram, TikTok, LinkedIn, X, YouTube and 10 more networks, fill your next free slots, answer comments and DMs and read your analytics. The same entry in ~/.codex/config.toml works in the Codex CLI, the IDE extension and the desktop app.

Get started freeSetup guide
Terminal
codex mcp add breakreach --url https://api.breakreach.com/mcp

Codex opens your browser to sign in. If it doesn't, run codex mcp login breakreach.

Checked against Codex's docs on October 7, 2026. Breakreach is our product.

~/northbeam-site · codex
›Schedule the three posts in content/social/week-41.md into my next free slots
•Explored content/social/week-41.md
└Reading…
•Called breakreach.create_post({"useNextSlot":true})
└Running…
•Called breakreach.create_post({"useNextSlot":true})
└Running…
•Called breakreach.create_post({"useNextSlot":true})
└Running…
•
app.breakreach.com/calendar
This week4 queue slots
Tue
Wed
Thu
Fri
11 AM12 PM1 PM2 PM3 PM4 PM5 PM
Roastery1:00 PM
11:00 AM
Latte art tip11:00 AM
4:00 PM
Pour-over1:00 PM
11:00 AM
4:00 PM
Queued for Thursday at 11:00 AM
29 tools
Publish, schedule, comments, DMs, analytics and accounts.
15 networks
Instagram, TikTok, LinkedIn, X, YouTube, Facebook, Threads and 8 more.
Hosted
One URL, nothing to install. Scheduled posts go out with the session closed.

Add Breakreach to CodexOne entry, read by the CLI, the IDE extension and the app.

Sign in with OAuth

Recommended

Nothing to copy but the command. Codex registers itself with Breakreach, opens your browser to sign in, and keeps the token fresh.

  1. 1
    Add the server

    From a terminal. It writes the entry to ~/.codex/config.toml, then opens your browser: allow access there and Codex finishes the sign-in. Access tokens last 30 days and refresh on their own.

    Terminal
    codex mcp add breakreach --url https://api.breakreach.com/mcp
  2. 2
    Or edit config.toml, then sign in

    The same two lines by hand, then codex mcp login breakreach. A repo can carry its own .codex/config.toml, which Codex reads once you trust the project. Over SSH, add --no-browser: Codex prints the address to open and asks for the one the browser ends on.

    ~/.codex/config.toml
    [mcp_servers.breakreach]url = "https://api.breakreach.com/mcp"
  3. 3
    In the IDE extension or the app

    They read the same config.toml. If breakreach still needs a sign-in there, choose Authenticate in their MCP settings.

  4. 4
    Connect your social accounts

    Connect Instagram, TikTok, LinkedIn and the rest once in Breakreach (Settings, Accounts). Or ask the agent for a link: create_connect_link returns a page where you, or a client, connect accounts without a Breakreach login.

Use an API key

For codex exec in CI, or a machine where nobody can click through a browser sign-in. Codex reads the key from an environment variable and sends it as a bearer token; the config never holds the key itself.

  1. 1
    Create an API key

    In Breakreach, open Settings, API & MCP and create a key. It starts with br_ and reaches every workspace you're a member of. Keep it out of files you commit.

  2. 2
    Put the key in your environment

    Add export BREAKREACH_API_KEY=br_… to your shell profile, so every Codex session (and codex exec in a script) finds it.

  3. 3
    Add the server with the key

    From a terminal, or as three lines in config.toml.

    Terminal
    codex mcp add breakreach --url https://api.breakreach.com/mcp \  --bearer-token-env-var BREAKREACH_API_KEY
  4. 4
    Or edit config.toml

    A repo can carry its own .codex/config.toml, which Codex reads once you trust the project.

    ~/.codex/config.toml
    [mcp_servers.breakreach]url = "https://api.breakreach.com/mcp"bearer_token_env_var = "BREAKREACH_API_KEY"

Check it works. codex mcp list shows breakreach, and /mcp in a Codex session lists its 29 tools.

What to ask CodexRequests that work today, and the tools they call.

  • Schedule the posts in content/social/week-41.md into my next free slotscreate_post
  • Post https://cdn.northbeam.coffee/launch.jpg to Instagram, TikTok and LinkedIn tomorrow at 9 AM with a caption from the release notescreate_post
  • List my scheduled posts for next week and move anything on Saturday to Monday at 11:00list_posts, update_post
  • Which of last month's posts got the most views? Put the top 10 in a CSVget_content_performance
  • Read my unanswered Instagram DMs and draft a reply to each. Don't send yetlist_conversations, get_conversation_messages

What Codex can do with BreakreachThe same tools in every client.

Publish

  • create_postPublish now, schedule, take the next free slot or save a draft, on one or many accounts
  • update_postEdit, reschedule, approve a draft or retry a failed post
  • delete_postUnschedule and remove a post from Breakreach
  • list_postsPosts with status, time and numbers
  • upload_mediaCopy a public image or video URL to Breakreach storage
  • get_next_slotThe next free slot of the posting schedule
  • list_pinterest_boardsBoards a pin can go to

Accounts

  • list_workspacesWorkspaces, one per brand or client
  • create_workspaceA new workspace for a new brand or client
  • list_accountsConnected accounts, with a warning before one expires
  • create_connect_linkA link where you or a client connect accounts, no Breakreach login needed
  • get_account_statsFollowers and 28-day numbers per account
  • get_account_trendsDay by day reach and views

Analytics

  • get_content_performanceEvery post's numbers over N days, sorted the way you ask
  • get_post_insightsEverything about one post, against the account average
  • get_post_metricsOne Breakreach post's views, likes, comments and shares
  • get_analyticsTotals and top posts made with Breakreach

Comments and DMs

  • list_recent_commentsNew comments across Instagram, Facebook, Threads and X
  • get_post_commentsThe comments on one post
  • reply_to_commentAnswer as the account
  • hide_commentHide or unhide (Instagram, Facebook, Threads)
  • delete_commentDelete for good (Instagram, Facebook)
  • list_conversationsDMs on Instagram, Facebook Messenger and X
  • get_conversation_messagesRead one conversation
  • send_messageReply to a DM as the account

Comment to DM

  • list_comment_dm_rulesInstagram keyword rules, their stats and latest DMs
  • create_comment_dm_ruleDM everyone who comments a keyword on a post or reel
  • update_comment_dm_ruleNew keywords or message, or pause the rule
  • delete_comment_dm_ruleRemove a rule and its activity

Why schedule from Codex?It finishes the whole task.

Codex is good at jobs with many small steps: read a file, do the same thing ten times, check each result, report back. A week of social posts is exactly that. Keep the plan in the repo, a markdown or CSV file with the text, the image URL and the networks per post, and Codex turns it into scheduled posts, one create_post per line, then lists what it did.

  • A content calendar in the repoEdit the file in a pull request, merge it, ask Codex to schedule it. The history of what went out is in git.
  • Your posting schedule, filleduseNextSlot puts each post in the next free slot of your schedule (weekdays at 11:00 and 16:00 until you change it), so ten posts become two weeks of posting.
  • Reports as files“Top 10 posts of last month as a CSV” calls the analytics tools and writes the file.
  • Moving things around“Move Saturday's posts to Monday” reads the queue and reschedules each one with update_post.

Can I run it from a script with codex exec?Yes, it reads the same config.

codex exec runs one task without the interactive session, with the same config.toml and the same sign-in. On a CI runner, where nobody can sign in, use the API key setup and set BREAKREACH_API_KEY in the job's environment (a CI secret). Scheduled posts publish from Breakreach's servers, so the job can end once Codex has made the calls.

Release job
codex exec "Announce the release in CHANGELOG.md on X and LinkedIn tomorrow at 9 AM"

For anything that runs unattended, ask for drafts (“save them as drafts”) and approve them in Breakreach, or limit the job to posting to accounts you're sure of.

Can Codex post images from my machine?

Through a public URL. The server downloads media from the web, so give Codex the URL of the image on your site, a CDN or a bucket, and it can call upload_media to keep a copy on Breakreach's storage for scheduled posts. Instagram, TikTok, YouTube and Pinterest need a photo or a video; the other eight networks also take text alone.

What does it cost?

Creating a Breakreach account and connecting your first social account is free. Scheduling and publishing need a plan, from $29 a month ($23 billed yearly) for 5 accounts, or the Developer plan at $5 per connected account. Signed in with OAuth before you subscribe, the reading tools work and the publishing ones answer with a link to the plans. An API key needs an active plan or trial, and answers 402 otherwise. Codex's own plan is separate.

Troubleshooting Breakreach in Codex

  • breakreach doesn't start, or answers 401Signed in with OAuth, run codex mcp login breakreach again. With an API key, BREAKREACH_API_KEY isn't set in the environment Codex runs in: export it in your shell profile and start a new session.
  • The browser doesn't open (SSH, a remote machine)Run codex mcp login breakreach --no-browser, open the address it prints on any machine, and paste back the address the browser ends on.
  • 402: API access requires an active subscriptionAPI keys need a plan or a trial on the Breakreach account.
  • “No free slot found in the next 14 days”Your posting schedule is full or empty. Add slots in Breakreach (Settings, Schedule), or give times instead.
  • “No social accounts connected yet”Connect them in Breakreach, or ask Codex for a connect link.
  • “Media is required for: tiktok”Instagram, TikTok, YouTube and Pinterest need an image or video URL.

The same server in other agents

Claude CodeOne command, then /mcp to sign in.CursorOne entry in mcp.json, then Connect.OpenClawPost and answer comments from your chat app.HermesOne command, OAuth or an API key.GrokGrok Build, the xAI API, or Grok Bot.ChatGPTThe plugin in ChatGPT.ClaudeThe connector in Claude's app.Any MCP clientThe URL and both ways to sign in.
FAQ

Questions, answered.

Short answers about Breakreach in Codex.

Yes. Run codex mcp add breakreach --url https://api.breakreach.com/mcp and sign in in the browser, and Codex gets 29 tools to post, schedule, answer comments and DMs and read analytics on 15 networks.

Yes. The CLI, the IDE extension and the desktop app read the same config.toml, so one entry covers all three.

Yes. Ask it to schedule a file of posts: it calls create_post once per post, at the times you give or in the next free slots of your posting schedule.

No. Codex signs in with OAuth: codex mcp add opens the sign-in, and codex mcp login breakreach runs it again. An API key through bearer_token_env_var suits CI jobs and machines without a browser.

Same server and same tools. In ChatGPT's chat, add the plugin from the directory; in Codex, add the server to config.toml.

Creating an account and connecting your first social account is free. Scheduling and publishing need a plan, from $29 a month for 5 accounts, or the Developer plan at $5 per connected account.

Keep reading

Breakreach in Claude CodeOne command, then /mcp.Breakreach in CursorOne entry in mcp.json.Breakreach in OpenClawPost from WhatsApp or Telegram.Scheduling APITimes, slots and drafts.Post to Instagram from ChatGPTThe connector in ChatGPT.Analytics APIPer-post and account metrics.
Instagram
TikTok
LinkedIn
YouTube
X
Facebook
Threads

Give Codex your social accounts.Set up in two minutes.

Get started

Your first account is free to connect. Plans from $29 a month.