Codex + Instagram

Instagram 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 Instagram 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 an Instagram caption for the launch image I attach

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 Instagram

What Bolta does on Instagram

Instagram will not take text alone. Bolta needs an image or video before it will approve the post, so the draft starts with the media you want to use.

  • Feed posts, Reels and Stories. A post is a feed post unless you set Reels or Story.
  • An image or video is required for every Instagram post.
Limits and format

Instagram limits and format rules

Network rules last checked 2026-07-28. Bolta's posting rules for your workspace (get-posting-rules) win if they differ from this page.

Not promised for Instagram from Codex: Replies to Instagram comments and a search for Instagram conversations. Bolta's reply tools are not wired for Instagram, so this page does not promise either. Collab posts, Close Friends and direct messages.

Instagram limits and format rules
What to knowInstagram's own ruleWhat Bolta does
Caption lengthNot stated on this page.2,200 characters. Longer text is trimmed back to the last whole sentence or word that fits. That applies to the caption Bolta builds from your text. A caption you set yourself is sent as written, with no length check.
Reel lengthReels can be up to 20 minutes long, with 3 minutes the recommendation cutoff.Bolta does not check video length or file size, so Instagram makes that call.
CarouselsOne post can hold up to 20 photos and videos as a swipeable carousel.A carousel in Bolta takes 2 to 10 files.
Image sizeInstagram caps shared photos at 1080 pixels wide, sizing larger uploads down.Feed images should sit between 4:5 and 1.91:1, and Story images between 9:16 and 1.91:1.
Story videoA story video up to 60 seconds stays one clip. Longer footage is broken into several clips.Bolta does not check video length. A Story cannot be a carousel.
Best practices

Codex jobs for Instagram, and how to write them

  • Have a script call codex exec to save a weekly draft batch for your team to review
  • Check which recent posts did best before Codex suggests what to write next
  • Start with the media. Instagram needs an image or video, so attach it before you ask for the caption.
Prompts

Example prompts for Instagram

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 an Instagram caption for the launch image I attach

Which of my recent posts got the most reactions? Suggest one follow-up and save it as a draft.

Draft an Instagram caption from the README tagline and tell me which image or video the post still needs

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 Instagram post in your brand voice (save-post). A saved draft is never public.

  2. 02

    You read the exact text

    On Instagram the exact text includes the caption and the media it sits on, and whether it is a feed post, a Reel or a Story.

  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 Instagram

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

For Instagram, Codex, from OpenAI, reaches Bolta through codex mcp add, or a [mcp_servers.bolta] entry in config.toml. Sign-in: Sign in (OAuth). The Instagram 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. An Instagram 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: Send the three drafts I just wrote to my teammate for review instead of keeping them to myself. The reply goes along these lines: I can send them to review in Bolta so a teammate sees them in their list. I have not approved them. Tell me which teammate and I will confirm before sending. Nothing sent yet. Waits for your yes.

Sign in once with codex mcp login bolta on the machine that runs the job. Use --no-browser on a server.

Keep the coding session on the branch. Open a second codex session in the same repo just for the announcement.

The connection is the standard Codex route for a remote MCP server, and the commands on this page come from Codex's own documentation. What we have not done is run a complete draft, review and schedule cycle through Codex.

  • Review and approval. Ask what is waiting for your yes, read each draft back, then approve or reject with your own reason. Bolta wants the exact text before a post is approved.
  • 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.
  • 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.
  • Wait for your yes. Codex shows you the exact text. Only after you approve it does anything get a time or go out. This step is you, not a tool.
  • Setup: Check that Codex sees Bolta. Run codex mcp list and look for bolta. Or start codex and type /mcp to see the active servers.
  • 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.
  • Hosted MCP with sign-in. Run codex mcp add bolta --url https://mcp.bolta.ai/mcp, then codex mcp login bolta. This is the route in Codex's own docs for a remote server with sign-in, and the one we recommend. We have not run a full draft-to-schedule cycle through it.
  • Scheduled posts you approved earlier still go out at their time, because Bolta holds them.
  • Start a new session and ask. Open a fresh codex session and type: What is waiting for my yes in Bolta? Then ask for a first draft from CHANGELOG.md. Approve the text before anything goes out.
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

Instagram questions, answered for Codex

Can Codex post text to Instagram without an image?
No. Bolta will not approve an Instagram post without an image or video, so attach the media first. A post is a normal feed post unless you ask for a Reel or a Story.
How long can an Instagram caption from Codex be?
Bolta uses 2,200 characters and trims a longer caption back to the last whole sentence or word that fits. That applies to the caption Bolta builds from your text, so a caption you set yourself is sent as written, unchecked.
Do I need an API key to connect Codex to Bolta?
No. The recommended route is a browser sign-in: run codex mcp login bolta and tick the brands to share. Codex can also read a token from an environment variable, but we have not tested that against Bolta, so use sign-in.
Which brands can Codex reach, and how do I add another one?
Only the brands you ticked at sign-in, since one connection is one organization. With more than one ticked, say which brand a draft is for, for example the side project and not the main one. To add another, run codex mcp login bolta again and tick it.
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.
codex mcp list does not show bolta
The entry did not save. Re-run codex mcp add bolta --url https://mcp.bolta.ai/mcp, or check that [mcp_servers.bolta] and the url line are in ~/.codex/config.toml, then start a new session.
Does Codex publish Instagram posts without my yes?
No. Nothing is approved, scheduled or published until you say yes to that Instagram 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.

Instagram from other AI agents

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

Try an Instagram draft from Codex

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