Codex + Mastodon

Mastodon posts with Codex and Bolta

Turn what you ship into social drafts from Codex, with your yes before anything posts. Parts of the Codex route are not confirmed yet, and the note below says which. Nothing goes live on Mastodon until you say yes.

One command or two lines in ~/.codex/config.toml, then codex mcp login bolta opens a Bolta sign-in page. You tick which brands Codex may reach.

CodexBolta connected
You

Read the top entry in CHANGELOG.md and draft a Mastodon post about it inside my instance's limit

Illustration of the reply: Bolta returns a draft showing the connected account and the scheduled time, with Approve, Edit and Reject actions.

Illustration. Your drafts show your real text, account and time.

What is and is not confirmed

Read this before you set up Codex

  • Confirmed: Codex's official docs describe adding a remote MCP server by URL, with a browser sign-in through codex mcp login. Bolta's connection uses exactly that standard route.
  • Confirmed: Codex finds skills in folders that contain a SKILL.md file, so the optional Bolta skill is a normal skill for it.
  • Not confirmed: nobody at Bolta has run a full draft, review and schedule cycle through Codex yet. Treat the first run as a test and check each result.
  • Not confirmed: Bolta's skills README lists npx skills add for Codex CLI, marked not tested. We have not run that install for Codex ourselves.
  • Not confirmed: a Bearer API key through bearer_token_env_var, and any Codex-specific plugin entry for Bolta. Sign-in is the path to use.
Bolta on Mastodon

What Bolta does on Mastodon

The text limit on Mastodon is set by your own instance, and Bolta reads it for the connected account instead of using one fixed number. The usual limit is 500 characters.

  • Text posts, within the limit your instance sets.
  • Public posts by default, or another visibility if you set it.
Limits and format

Mastodon limits and format rules

Bolta's posting rules for your workspace (get-posting-rules) win if they differ from this page.

Not promised for Mastodon from Codex: Polls, threads and instance-specific features. None is confirmed for Bolta. Any rule from a particular instance. Each instance sets its own, so check yours.

Mastodon limits and format rules
What to knowMastodon's own ruleWhat Bolta does
Post lengthNot stated on this page.Set by your instance. Bolta reads it per account, and the usual limit is 500. Text over the limit is trimmed back to the last whole sentence or word that fits.
VisibilityNot stated on this page.Public unless you set another visibility.
FormattingNot stated on this page.Mastodon posts are plain text here. Markdown is flattened, and #hashtags and @mentions stay as typed.
Finding conversationsNot stated on this page.Hashtag-based. The query is folded into a single tag, because full-text status search is unavailable on most instances.
Best practices

Codex jobs for Mastodon, and how to write them

  • Check which recent posts did best before Codex suggests what to write next
  • Set up a weekly routine from the terminal that drafts posts and waits for your approval
  • Ask for your instance's limit before drafting. It differs from instance to instance.
Prompts

Example prompts for Mastodon

Things to type in Codex. Each one asks for a draft and shows you the text first.

Read the top entry in CHANGELOG.md and draft a Mastodon post about it inside my instance's limit

What is waiting for my yes in Bolta right now?

Turn the release notes into a Mastodon post with one relevant hashtag and show it to me first

Send the three drafts I just wrote to my teammate for review instead of keeping them to myself.

Review

Bolta saves a draft, you read the exact text, you say yes

  1. 01

    Bolta saves a draft

    Codex asks Bolta for the Mastodon post in your brand voice (save-post). A saved draft is never public.

  2. 02

    You read the exact text

    On Mastodon the exact text includes its visibility, because the default is public, and where the limit for your instance would cut it.

  3. 03

    You say yes

    Only then does Bolta schedule or publish (publish-post), in your workspace's timezone. Safe Mode, client sign-off and brand approval rules still apply.

Codex and Bolta

Using Codex for Mastodon

Parts of this route are not confirmed. The note above says which.

For Mastodon, Codex, from OpenAI, reaches Bolta through codex mcp add, or a [mcp_servers.bolta] entry in config.toml. Sign-in: Sign in (OAuth). The Mastodon account itself is connected inside Bolta, not in Codex.

Codex is OpenAI's coding agent for the terminal, IDE and desktop app, separate from the ChatGPT chat app. A Mastodon draft usually starts from what you just shipped, read from files in your project.

An illustration from the Codex guide, not real output. You ask: What is waiting for my yes in Bolta right now? The reply goes along these lines: You have three items to review: two drafts from the weekly routine and one reply suggestion. I have not approved anything. Want me to show the exact text of the first draft? Read only. Nothing changed.

Codex's docs say exec runs in a read-only sandbox by default and expects a Git repository, and that project-defined MCP servers load only for trusted projects. Keep Bolta in your user ~/.codex/config.toml and read the non-interactive page before you wire it into CI.

Both sessions use the Bolta connection you already signed in. Each one needs to be started after you added the server.

Codex's docs say project-defined MCP servers load only for trusted projects. The entry on this page holds only the Bolta server address. Each person signs in themselves with codex mcp login bolta.

  • Weekly routines. Describe a routine in plain words, for example two build-in-public posts every Friday. Codex shows the plan, and it is saved switched off until you give a separate yes.
  • Voice and brand. Codex can read your brand context and voice so drafts match how you write, and it can help set up a voice profile from samples.
  • Find the right brand. Codex asks Bolta which organizations and brands this connection may reach, so a post about your side project does not land on the company brand.
  • Check the rules for the network. It reads the posting rules for the account, such as length, so the draft fits before you see it.
  • Setup: Add the Bolta skill. Optional, and it helps Codex follow your voice, your review list and the approval rule. Run npx skills add boltaai/bolta-skills --skill bolta and choose Codex if it asks. Codex looks for skills in .agents/skills inside a repo or ~/.agents/skills for your user.
  • Setup: Test with a read-only question. Ask: What is waiting for my yes in Bolta? Allow the tool call if Codex asks. This reads your review list and changes nothing.
  • Plugin or extension. Codex has plugins that bundle skills and connectors, but nobody here has checked a Bolta entry for it. Do not rely on one.
  • A draft already saved in Bolta stays put until you approve it. Closing the terminal does not lose it.
  • codex mcp add. Choose this if you want it done in one line. Run codex mcp add bolta --url https://mcp.bolta.ai/mcp, then codex mcp login bolta. Nothing to edit by hand.
Connect

Connect Codex to Bolta

One command or two lines in ~/.codex/config.toml, then codex mcp login bolta opens a Bolta sign-in page. You tick which brands Codex may reach.

FAQ

Mastodon questions, answered for Codex

What is the Mastodon character limit for a post from Codex?
It depends on your instance. Bolta reads the limit for the connected account, and the usual limit is 500 characters. Anything over it is trimmed back to the last whole sentence or word.
Are Mastodon posts from Codex public?
Yes, unless you set another visibility. Say who may see the post when you ask, and check it when you read the draft.
Is this tested end to end?
Not yet. The connection follows Codex's documented route, but no one has run a full draft, review and schedule cycle through Codex. Claude Code is the most tested path.
What can Codex not do through Bolta?
Anything your Bolta role does not allow. Viewers cannot approve or publish, and Safe Mode and client sign-off still apply on top. A network you have not connected is out of reach too.
Can Codex in the IDE or desktop app use Bolta, or only the terminal?
Codex's MCP docs say the ChatGPT desktop app, Codex CLI and IDE extension share this configuration, so the entry you add once should show up in each. We have only described the terminal commands here, so check /mcp in the one you use.
Why did Codex say it cannot schedule my post?
Usually because nobody has said yes to the exact text yet, or your role in Bolta does not allow it. Bolta refuses on purpose in those cases. Approve the draft, or ask an owner or admin if it is a role limit.
Does Codex publish Mastodon posts without my yes?
No. Nothing is approved, scheduled or published until you say yes to that Mastodon post. Whether Codex completes the connection is not fully confirmed, so read the note above first.

More from Codex

Codex can work with the other networks Bolta publishes to. Each page has its own limits and review notes.

Mastodon from other AI agents

The same Mastodon limits apply whichever agent asks. The connection and the setup are what change.

Try a Mastodon draft from Codex

Connect Codex, ask for a Mastodon draft and read the exact text. Nothing goes live until you say yes.