November 28, 2026 at 9:59 AM UTC
Claim now: Black Friday: save up to 50% on all plans
Codex x ContentStudio

Schedule social media posts with Codex

Connect ContentStudio to Codex, OpenAI's coding agent, with the ContentStudio CLI and skill or the ContentStudio MCP server. Then ask Codex to schedule posts, upload media, and handle approvals across your social accounts without leaving your terminal.

Standalone white 3D OpenAI knot for Codex
Bash
$codex mcp add contentstudio --url https://mcp.contentstudio.io/mcp?api_key=YOUR_API_KEY

Publishes to:

Quick Reference

Everything you need to get started

Skill install
npx skills add contentstudioio/contentstudio-agent
CLI package
contentstudio-cli
MCP server
https://mcp.contentstudio.io/mcp?api_key=YOUR_API_KEY
Auth method
ContentStudio API key | https://mcp.contentstudio.io/mcp?api_key=YOUR_API_KEY. Where OAuth is not supported, use api_key in the query parameter or x-api-key in the header.
Requirements
An active ContentStudio API key

Core Capabilities

What Codex can do once it is connected

Codex can do anything the ContentStudio CLI and MCP tools expose: post to your accounts, upload media, run approvals, leave comments, and keep each client's workspace separate.

01

Post to many accounts in one request

Codex repeats the account flag for every network you name, so one request becomes one post on Facebook, LinkedIn, X, and more. Save it as a draft, add it to the queue, or schedule it for a set time.

02

Analytics and inbox

Through the MCP server, Codex can pull performance data and read and reply to messages.

03

AI images and videos

Generate AI images and videos from a prompt, then attach them to posts in one request.

04

Approve or reject

Approve pending posts or send them back, each with a comment explaining why.

05

Comments and notes

Add public comments or internal notes to any post, and mention teammates.

06

Find and clean up posts

List posts by status or date, and delete them from ContentStudio or from the social network too.

07

Platform-specific options

Set YouTube categories, TikTok privacy, Pinterest links, and Google Business events with a JSON body.

08

Connect social accounts

Get a one-time sign-in link for OAuth platforms, or add Bluesky with an app password.

09

Switch workspaces

Set the active client workspace, or run one command against another without changing your default.

Setup

Get started in two steps

Two quick steps are all it takes to connect Codex with ContentStudio and start scheduling your social media from your terminal.

1

1 - Connect

Open (or create) ~/.codex/config.toml and add an entry under mcp_servers, with your API key from Settings → API Keys in place of YOUR_API_KEY. Where OAuth is not supported, use api_key in the query parameter or x-api-key in the header.

[mcp_servers.contentstudio]
url = "https://mcp.contentstudio.io/mcp?api_key=YOUR_API_KEY"
2

2 - Ask

Once it’s connected, just ask Codex to do the work: “Schedule this post for tomorrow at 9am” or “Show me what’s queued this week on ContentStudio.” Codex calls ContentStudio through the MCP server, no separate login step needed. Details on the ContentStudio MCP server page.

Using the integration

See Codex in action

Anything the ContentStudio CLI or MCP tools expose. Here are a few things you can say to Codex, and the ContentStudio commands it runs behind the scenes.

Ship a Launch Post

> Post “Big launch today” with launch.jpg to Facebook, LinkedIn, and X on May 1 at 10 AM.

✓ Codex looks up each account with accounts:list, then runs one posts:create with all three.

Post a Folder of Images

> Upload every image in ./photos and create one Instagram feed post per image.

✓ Codex runs media:upload for each file, then posts:create with the returned media ID.

Schedule a Week of Daily Posts

> Schedule a daily post for the next 7 days at 9 AM on our Facebook page, one theme per day.

✓ Seven scheduled posts in your ContentStudio calendar, one per day.

Publish a YouTube Short

> Schedule clip.mp4 as a public YouTube Short in the Education category with three tags.

✓ Codex writes a JSON body with youtube_options and passes it with --body.

Clear the Approval Queue

> Approve every pending post from our trusted creator and leave a note on each.

✓ Codex lists posts with status pending_approval and runs posts:approve with a comment.

Delete Stale Drafts

> Delete drafts older than 30 days. Show me a dry run first.

✓ Codex lists old drafts, previews each delete with --dry-run, then runs it once you say go.

Security & Trust

Codex works with guardrails on

A key you can revoke, a preview on every write, and typed errors keep every action Codex takes safe and easy to check.

✓

Dry-run on every write: Every create, delete, approval, comment, upload, or connect command takes --dry-run, which prints the full request and exits without touching the API.

✓

Human in the loop: Save posts as drafts, or send them through your workspace approval workflow, so your team decides what goes live.

✓

Typed errors: With --json, every command returns the same shape, and each failure has its own exit code, so Codex can tell a bad key from a missing post.

Platforms

Which platforms can Codex post to?

Every network connected in ContentStudio, with the post types and options each one needs.

PlatformPost types
FacebookFeed, Reel, Story, carousel, video, poll
InstagramFeed, carousel, Reel, Story
X (Twitter)Feed and threads
LinkedInFeed, document carousel, video, poll
TikTokVideo and photo posts
PinterestImage, video, carousel pins
YouTubeVideos and Shorts
ThreadsPosts and multi-post threads
BlueskyFeed posts
TelegramChannel posts
TumblrFeed posts
Google Business ProfileUpdates, events, offers, CTAs

Codex or ChatGPT

Is Codex the same as ChatGPT?

No. Both are made by OpenAI and both can run ContentStudio, but ChatGPT is the chat assistant and Codex is the coding agent. They reach ContentStudio through different doors. Using ChatGPT instead? See the ContentStudio ChatGPT integration.

Codex (coding agent)ChatGPT (chat assistant)
What it's forFor repeatable jobs and work in your terminal.For planning and posting by conversation.
You say“Upload every image in ./photos and make one Instagram post per image.”“Plan next week's LinkedIn posts and show me before you schedule them.”
ConnectsThe CLI and skill, or the MCP serverThe official ContentStudio app
YouHand it a task and it chains the stepsReview and confirm each step
Lives inYour terminal and IDEchatgpt.com and the ChatGPT apps

Troubleshooting

Quick fixes for common problems

Most issues come down to the MCP connection, the API key, or the wrong workspace.

Server doesn't show up in Codex's connected tools

Check that the URL in config.toml was entered correctly, including ?api_key=. A bare https://mcp.contentstudio.io/mcp with no key gets saved but sometimes won't connect. Confirm the file is saved and Codex was restarted after adding it. Where OAuth is not supported, use api_key in the query parameter or x-api-key in the header.

Keeps failing to connect / shows as disconnected

This usually means the API key in the URL is wrong, expired, or was regenerated in ContentStudio after the entry was added. Generate a fresh key from Settings → API Keys, update the URL in config.toml, and restart Codex.

Pulling the wrong workspace's data

The API key is tied to one ContentStudio workspace. If you manage multiple workspaces, check which key is in the URL. Generate a key from the correct workspace and update the entry with that URL.

Every AI agent ContentStudio connects to

One account, one set of tools. Pick the agent you already work in, or browse all of them below.

Building something custom? Browse every ContentStudio integration.

FAQs

What is the ContentStudio Codex integration?+
It connects Codex, OpenAI's coding agent, to your ContentStudio account through the ContentStudio CLI and skill or the ContentStudio MCP server. Once connected, Codex can schedule posts, upload media, handle approvals, and manage comments from your terminal.
Should I use the ContentStudio skill or the MCP server with Codex?+
Use the skill for scripts, bulk jobs, local file uploads, and dry runs. Use the MCP server for the quickest setup, plus analytics and inbox. You can use both.
Is Codex the same as ChatGPT?+
No. ChatGPT is OpenAI's chat assistant and connects through the official ContentStudio app. Codex is OpenAI's coding agent and connects through the CLI and skill or the MCP server.
Does Codex need my social media passwords or an API key?+
Never your social passwords. The CLI uses a ContentStudio API key from Settings → API Keys. The MCP server takes the same key in its link, as ?api_key=.
Can Codex post to several platforms in one request?+
Yes. Codex adds every account you name to a single posts:create command, so one request becomes one post across all of them.
Can Codex run social media posting without me, on a schedule?+
Scheduled posts publish from your ContentStudio calendar on their own. For recurring jobs, put contentstudio commands in a bash script or CI/CD pipeline. Save posts as drafts if you want a person to review them first.
How do I preview what Codex will send?+
Ask Codex to add --dry-run. The CLI prints the full request and exits without touching the API.
Which platforms can Codex post to?+
Facebook, Instagram, X, LinkedIn, TikTok, Pinterest, YouTube, Threads, Bluesky, Telegram, Tumblr, and Google Business Profile.
Is it free to start?+
ContentStudio has a 7-day free trial with no credit card, so you can connect Codex and try it on your own accounts.

Automate your social media with Codex and ContentStudio

Install the CLI and skill or connect the MCP server, and let Codex draft, schedule, and approve social posts from your terminal.

  • Scoped API key
  • Dry-run before writes
  • Workspace confirmation

7-day free trial · No credit card · Cancel anytime

Standalone white 3D OpenAI knot for Codex