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.

Start your free trial Connect Codex

Standalone white 3D OpenAI knot for Codex

Bash

$npm install -g contentstudio-cli
 
$npx skills add contentstudioio/contentstudio-agent
 
$contentstudio auth:login --api-key cs_...

Publishes to:

Quick Reference Core Capabilities Setup One more way to connect Using the integration Security & Trust Platforms Codex or ChatGPT Troubleshooting More AI Agents FAQs

Quick Reference

Everything you need to get started

Skill install: npx skills add contentstudioio/contentstudio-agent
CLI package: contentstudio-cli
MCP server: codex mcp add contentstudio --url https://mcp.contentstudio.io/mcp
Source (open, MIT-0): github.com/contentstudioio/contentstudio-agent
Auth method: API key (cs_…) via auth:login (CLI) or codex mcp login contentstudio (MCP)
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.

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.

Analytics and inbox

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

AI images and videos

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

Approve or reject

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

Comments and notes

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

Find and clean up posts

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

Platform-specific options

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

Connect social accounts

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

Switch workspaces

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

Setup

Get started in three steps

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

1 - Install the ContentStudio CLI

Install the CLI globally with npm. This is what Codex uses to talk to the ContentStudio API.

npm install -g contentstudio-cli

2 - Add the skill for Codex

Install the skill file so Codex knows every ContentStudio command without extra prompting. Pick Codex when the installer asks which agents to install into.

npx skills add contentstudioio/contentstudio-agent

3 - Authenticate

Generate an API key from Dashboard → Settings → API Keys, then use it to authenticate the ContentStudio CLI.

contentstudio auth:login --api-key cs_...

One more way to connect

Prefer a sign-in with no key to manage? Add the ContentStudio MCP server instead.

1 - MCP server (no API key)

MCP (Model Context Protocol) is the open standard Codex uses to call outside tools. Add the ContentStudio MCP server, then sign in with your ContentStudio account.

codex mcp add contentstudio \
  --url https://mcp.contentstudio.io/mcp
codex mcp login contentstudio

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.

✓

Scoped API key: The CLI uses a single cs_ API key that talks only to the ContentStudio public API. Revoke or replace it anytime without exposing your social account passwords.

✓

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.

Platform	Post types
Facebook	Feed, Reel, Story, carousel, video, poll
Instagram	Feed, carousel, Reel, Story
X (Twitter)	Feed and threads
LinkedIn	Feed, document carousel, video, poll
TikTok	Video and photo posts
Pinterest	Image, video, carousel pins
YouTube	Videos and Shorts
Threads	Posts and multi-post threads
Bluesky	Feed posts
Telegram	Channel posts
Tumblr	Feed posts
Google Business Profile	Updates, 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 for	For 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.”
Connects	The CLI and skill, or the MCP server	The official ContentStudio app
You	Hand it a task and it chains the steps	Review and confirm each step
Lives in	Your terminal and IDE	chatgpt.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.

“You must authenticate first”

Run contentstudio auth:status. If has_api_key is false, run contentstudio auth:login --api-key cs_... with a key from Dashboard → Settings → API Keys.

AuthError (401 / 403)

Your key is missing or invalid. Generate a fresh one in the dashboard and run auth:login again.

Key not seen in a service setup

A shell export doesn't carry into a running service. Set CONTENTSTUDIO_API_KEY in the service's own environment, then restart it.

NotFoundError

The post, account, or file belongs to a different workspace. Check the active one with contentstudio workspaces:current.

RateLimitError (429)

The CLI retries automatically, up to 2 times with backoff. For big jobs, ask Codex to work in smaller batches.

MCP tools not showing

Run codex mcp login contentstudio to sign in again. Can't use a browser? Pass your key in the link: https://mcp.contentstudio.io/mcp?key=YOUR_API_KEY

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.

How do I connect Codex to ContentStudio?+

Install the CLI with npm install -g contentstudio-cli, add the skill with npx skills add contentstudioio/contentstudio-agent, and log in with contentstudio auth:login --api-key cs_.... Or add the MCP server with codex mcp add contentstudio --url https://mcp.contentstudio.io/mcp and sign in with codex mcp login contentstudio.

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 with no key to manage, 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 uses your ContentStudio sign-in instead.

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.