logo
CodexCodex + Postiz

Schedule Social Media Posts with Codex

  • Install the Postiz skill or MCP server in a minute
  • Codex lists channels, uploads media, schedules posts
  • Works from your terminal, IDE or a codex exec script
Start for $0
View Docs

Postiz is the agentic social media scheduling platform that Codex drives through the Postiz skill and MCP server. Please make sure there is always a human in the loop. Last updated: September 2026.

How do I connect Codex to Postiz?

Codex connects to Postiz two ways: install the Postiz skill (which drives the Postiz CLI), or add the Postiz MCP server with codex mcp add. Both take a minute, and you can use both.

1Install
about a minute

Install the Postiz skill

Two commands add the postiz skill and CLI to Codex. Authenticate once and Codex can reach every channel you connected in Postiz.

terminal
# Postiz skill + CLI
npx skills add gitroomhq/postiz-agent
npm install -g postiz
export POSTIZ_API_KEY=your_api_key   # or: postiz auth:login

Prefer OAuth with no API key? Add the MCP server instead: codex mcp add postiz --url https://mcp.postiz.com/mcp-oauth-dynamic, then codex mcp login postiz. Details on the Postiz MCP page.

2Ask
live in Postiz

Ask Codex to post for you

Codex loads the skill, calls the Postiz CLI and schedules the post. Postiz publishes it on time even after the session ends.

Post "Hello from Postiz!" to X and LinkedIn, schedule it for tomorrow at 9am

Codex

Loaded the postiz skill and found 2 channels: X and LinkedIn. Scheduled both posts for tomorrow at 9:00 AM. Run postiz posts:list to review the queue.

via PostizXLinkedin

Also try

List my connected channelsWhat flairs are in r/programming?Cancel tomorrow's LinkedIn post
  1. 1Install the Codex CLI (npm install -g @openai/codex) or the IDE extension and sign in
  2. 2Add Postiz with npx skills add gitroomhq/postiz-agent, or codex mcp add postiz with the MCP link
  3. 3Connect the social accounts you want Codex to post to in your Postiz dashboard
  4. 4Ask Codex what to post, interactively or with codex exec. It uploads media and schedules through Postiz

Postiz skill vs Postiz MCP server in Codex

Pick MCP for the fastest OAuth setup, pick the skill when you want the Postiz CLI in scripts. Both reach the same channels.

Postiz skill (CLI)Postiz MCP server
Setupnpx skills add gitroomhq/postiz-agent, then npm install -g postizcodex mcp add postiz --url https://mcp.postiz.com/mcp-oauth-dynamic
Authenticationpostiz auth:login (OAuth2 device flow) or POSTIZ_API_KEYcodex mcp login postiz (OAuth in the browser, no API key)
Where Codex loads it.agents/skills in your repo or ~/.agents/skills; invoke with $postiz~/.codex/config.toml under [mcp_servers.postiz]
Mediapostiz upload <file>, then attach the returned URLMCP upload tools (from a URL or the upload widget)
Best forScripts, CI, and cron jobs with codex exec; full CLI controlQuick setup in the CLI or IDE extension; no key management
Works inCodex CLI and IDE extensionCodex CLI and IDE extension (shared config.toml)

One install powers every channel Codex can post to

Connect your accounts in Postiz once. From then on Codex can post to any of them from the terminal, and Postiz publishes at the time you set.

Codex
XLinkedInInstagramFacebookThreadsRedditYouTubeTikTokPinterestBlueskyDiscordSlackGoogle BusinessTelegramMastodonDribbbleWordPressMediumHashnodeDev.toTwitchKickWarpcastNostrLemmyVKMeWeWhopSkoolListmonk

What can Codex do with Postiz?

Codex can do anything the Postiz CLI and MCP tools expose: list channels, upload media, create and schedule posts with platform-specific settings, manage the queue, and read analytics.

AI Agent Ready

Postiz returns structured results, so Codex can plan, run, and verify multi-step social media workflows on its own.

30+ Platforms

Post to Twitter/X, LinkedIn, Reddit, Instagram, YouTube, TikTok, and 22 more platforms. One request from you, Codex handles every platform.

Threads & Comments

Create threaded posts with multiple comments, each with their own media. Automatic conversion to platform-native threads.

Rich Media Support

Upload and attach images, videos, audio, and documents. Supports PNG, JPG, MP4, MOV, PDF, and many more formats.

Scheduled Posting

Schedule posts with precise timestamps, create drafts for review, and batch schedule entire content campaigns.

Platform-Specific Settings

Dynamic discovery of platform features like Reddit flairs, YouTube playlists, Pinterest boards, and LinkedIn company pages.

How does Codex post to social media with Postiz?

Codex discovers your channels, composes the post, uploads media, and schedules it through Postiz. You describe what you want in plain language; here is how a typical conversation goes.

  1. 1

    Discover Integrations

    List all your connected social media accounts and discover platform-specific features like subreddit flairs and YouTube playlists.
    Example conversation
    > What social accounts do I have connected?

Codex: You have 4 channels connected:
  X, LinkedIn, Reddit, and YouTube.
  I can also check platform options like
  subreddit flairs or YouTube playlists.
  2. 2

    Create Posts

    Describe the post — content, media, comments, and any platform options — and Codex builds it, from a quick one-liner to a full campaign.
    Example conversation
    > Post "Check out our new feature!" with
  screenshot.png to X and LinkedIn,
  tomorrow at 9am

Codex: Done! Scheduled on X and LinkedIn
  for tomorrow at 9:00 AM with the image.
  3. 3

    Manage & Analyze

    List, filter, and manage your scheduled posts. Track performance with platform and post-level analytics. Ask for a week of content and Codex schedules the whole campaign.
    Example conversation
    > What's scheduled this week, and how did
  last month's posts perform?

Codex: 5 posts scheduled Mon-Fri.
  Last 30 days: 12.4k impressions, up 18%.
  Your best post was Tuesday's launch thread.

Can Codex post to multiple platforms in one request?

Yes. Ask once and Codex posts to every platform at the same time, each with its own media and settings. For example:

Example
> Post "Launching our new feature today!" with
  banner.png to X, LinkedIn, and Facebook tomorrow
  at 9am. On Reddit, post it to r/programming as a
  text post titled "New Tutorial". Then schedule a
  daily tip on X and LinkedIn for the rest of the week.

Codex: Done! Here's what I scheduled:
  - X, LinkedIn, Facebook: tomorrow 9:00 AM (banner.png)
  - Reddit r/programming: tomorrow 9:00 AM, "New Tutorial"
  - Daily tips: Mon-Fri 9:00 AM on X and LinkedIn

What is Codex?

Codex is OpenAI's coding agent. It runs as the Codex CLI in your terminal (npm install -g @openai/codex), as an IDE extension, and in the cloud. It signs in with your ChatGPT account or an API key, runs shell commands inside a sandbox with approval rules you set, and can call MCP servers, which is how it manages your social media with Postiz.

Terminal & IDE Native

Codex runs directly in your terminal or IDE. No browser or cloud setup needed — just tell Codex what you want and it manages your social media workflow.

Autonomous Execution

Codex works in a sandboxed environment. It reads the Postiz skill and chains the right steps together for complex workflows.

Parallel Tasks

Run multiple Codex sessions in parallel. Schedule posts on one terminal while analyzing metrics on another — each task runs independently and concurrently.

Is Codex the same as ChatGPT?

No. Both are made by OpenAI, but ChatGPT is the chat assistant and Codex is the coding agent. They reach Postiz through different doors.

CodexChatGPTClaude Code
Made byOpenAIOpenAIAnthropic
What it isCoding agent for terminal, IDE, and cloudChat assistant on chatgpt.com and desktop appsCoding agent for the terminal
How it reaches Postizpostiz skill or Postiz MCP server (codex mcp add)Official Postiz app or custom MCP connectorpostiz skill or Postiz MCP server (claude mcp add)
Headless automationcodex exec in scripts, CI, or cronScheduled posts run in Postiz; chat itself is interactiveclaude -p in scripts

Guides: ChatGPT + Postiz and Claude Code + Postiz.

How Postiz Works with Codex

Codex discovers Postiz two ways. The postiz skill is loaded from .agents/skills in your repo or ~/.agents/skills, and you can invoke it explicitly with $postiz. The Postiz MCP server is added with codex mcp add and stored in ~/.codex/config.toml. Either way, Codex learns the available tools and chains them for you.

  • Install the Postiz skill with npx skills add, or add the Postiz MCP server with codex mcp add
  • Codex loads skills from .agents/skills and reads SKILL.md to learn the Postiz CLI
  • Authenticate with POSTIZ_API_KEY or postiz auth:login; the MCP route uses OAuth via codex mcp login
  • Commands run in Codex's sandbox with approval rules you control
  • Run Postiz tasks in parallel with your coding workflows
Install Postiz
# Install the Postiz skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Or add the Postiz MCP server instead
codex mcp add postiz --url https://mcp.postiz.com/mcp-oauth-dynamic
codex mcp login postiz

# Then ask, interactively or headless
codex "list my social media integrations"
codex exec "schedule this week's posts from ./content"

How do I automate posting with codex exec?

Use codex exec to run a prompt non-interactively from a script, CI job, or cron entry. Codex loads the Postiz skill or MCP tools, discovers your channels, and schedules the posts; Postiz then publishes them on time without Codex running.

Just Ask Codex

Interactive or headless with codex exec

Tell Codex what to post from your terminal. It connects to Postiz, discovers your accounts, uploads media, and schedules posts. The same prompt works with codex exec for unattended runs; keep a human reviewing the queue.

codex exec (headless)
# Interactive
$ codex "Post my blog article to X, LinkedIn,
  and Reddit with the cover image,
  schedule for tomorrow at 9am"

# Headless, e.g. from cron every weekday at 8am
0 8 * * 1-5  cd ~/marketing && codex exec \
  "Schedule today's post from ./content/queue
   to X and LinkedIn at 9am"

Codex: I'll handle that.
  1. Loading the Postiz skill
  2. Found your integrations via Postiz
  3. Uploading cover image
  4. Scheduling across 3 platforms

  Done! Posts scheduled:
  - X (Twitter): scheduled 9:00 AM
  - LinkedIn: scheduled 9:00 AM
  - Reddit (r/programming): scheduled 9:00 AM

Parallel Tasks

Multiple agents, concurrent execution

Run multiple Codex sessions at the same time. Schedule a week of content in one terminal while refactoring code in another — each task runs independently.

Multiple Terminals
# Terminal 1 — schedule content
$ codex "Schedule a week of daily posts
  to Twitter and LinkedIn, using the
  content from ~/content/drafts"

# Terminal 2 — check analytics
$ codex "Get my social media analytics
  for the last 30 days across all
  platforms and summarize the results"

# Terminal 3 — keep coding
$ codex "Refactor the auth module
  to use JWT tokens"

Why Codex + Postiz

  • Runs in your terminal or IDE — just type what you want
  • Autonomous execution in a sandboxed environment
  • Parallel tasks — run social media and coding side by side
  • Skill or MCP: Codex learns the Postiz tools from SKILL.md or the MCP tool list
  • Cross-post to multiple platforms in a single request
  • Powered by OpenAI's most capable models
SKILL.md (loaded by Codex from .agents/skills)
---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms
homepage: https://docs.postiz.com/public-api/introduction
---

# Loaded by Codex from .agents/skills
# Invoke explicitly with $postiz

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

Also Works with Claude Code

Postiz works with any AI agent that can run commands or call MCP tools. That includes Anthropic's Claude Code, Cursor, and anything else that can run the Postiz Agent CLI or connect to the Postiz MCP server.

Claude Code

by Anthropic

Claude reads the Postiz skill so it knows what it can do. It autonomously discovers your integrations, uploads media, composes posts with platform-specific settings, and schedules content across all your connected platforms.

Claude Code
> Schedule a tweet for tomorrow morning
  announcing our new feature, attach
  the screenshot from ./assets/launch.png

Claude: Done! Scheduled on X for
  tomorrow at 9:00 AM.

What can I ask Codex to do in Postiz?

Anything the Postiz CLI or MCP tools expose. Here are a few things you can say to Codex; it handles the Postiz calls behind the scenes.

Announcement

Ship a launch post

Post "Launching our new feature today!" with banner.png to X, LinkedIn, and Facebook tomorrow at 9am.

Community

Post to a subreddit

What flairs are available in r/programming? Then post it there as a text post titled "New Tutorial".

Automation

Schedule a week of tips

Schedule a daily tip on X and LinkedIn for the rest of the week, using the content from ~/content/drafts.

Analytics

Check the queue and results

What's scheduled this week, and how did last month's posts perform? Cancel tomorrow's LinkedIn post.

Which platforms can Codex post to?

Codex can post to 30+ platforms through Postiz. Each of these has a dedicated Codex guide with example prompts, a settings reference, platform rules, and an FAQ.

X (Twitter)

Tweets, threads, and reply controls

LinkedIn

Professional posts and image carousels

Instagram

Feed posts, stories, and reels

Facebook

Text posts, links, and media

Reddit

Subreddits, flairs, and post types

YouTube

Video uploads, thumbnails, and tags

TikTok

Videos, privacy, duets, and stitches

Pinterest

Pins, boards, and link pins

Discord

Channel messaging and media

Slack

Channel messaging and team updates

Telegram

Bot-powered channel messaging

Twitch

Chat messages and announcements

Kick

Chat messages and notifications

Medium

Articles, publications, and tags

Dev.to

Developer articles and organizations

Hashnode

Blog posts and publications

WordPress

Posts, pages, and featured images

Dribbble

Design shots and team portfolios

Warpcast

Farcaster casts and channels

Lemmy

Federated community posts

Moltbook

AI agent social network

Google My Business

Business posts, events, and offers

Listmonk

Email campaigns and newsletters

Skool

Community posts and groups

Whop

Company forums and experiences

Codex and Postiz FAQ

What is Codex?

Codex is OpenAI's coding agent. It runs as the Codex CLI in your terminal (npm install -g @openai/codex), as an IDE extension, and in the cloud, signs in with your ChatGPT account or an API key, and can run shell commands and call MCP servers. That is how it drives Postiz to schedule and publish social media posts.

How do I connect Codex to Postiz?

Two options. For the CLI skill, run npx skills add gitroomhq/postiz-agent, install the Postiz CLI with npm install -g postiz, and authenticate with postiz auth:login or POSTIZ_API_KEY. For MCP, run codex mcp add postiz --url https://mcp.postiz.com/mcp-oauth-dynamic and then codex mcp login postiz. Then ask Codex what to post.

Is Codex the same as ChatGPT?

No. ChatGPT is OpenAI's chat assistant on chatgpt.com, and it connects to Postiz as an app or custom MCP connector. Codex is OpenAI's coding agent for the terminal, IDE, and cloud, and it reaches Postiz through the postiz skill or the Postiz MCP server. Both can post through Postiz; the setup differs.

Should I use the Postiz skill or the MCP server with Codex?

Use the MCP server if you want OAuth sign-in with no API key and a tool list Codex can call directly. Use the skill if you prefer the Postiz CLI, want scripted workflows with codex exec, or need the CLI's media upload flow. Both expose the same channels, and you can install both.

Can Codex run social media posting without me, on a schedule?

Yes. Postiz publishes scheduled posts at their time even when Codex is closed. For unattended runs, call codex exec with a prompt from a script, CI job, or cron entry, for example to schedule the day's posts from a content folder each morning. Keep a human reviewing what gets published.

Which platforms can Codex post to through Postiz?

30+ platforms, including X, LinkedIn, Instagram, Facebook, Reddit, YouTube, TikTok, Pinterest, Discord, Slack, Telegram, Twitch, Kick, Medium, Dev.to, Hashnode, WordPress, Dribbble, Warpcast, Lemmy, Moltbook, Google My Business, Listmonk, Skool, and Whop. Each one has a dedicated Codex guide with settings, prompts, and rules linked on this page.

Does Codex need my social media passwords or an API key?

No passwords, ever. You connect each social account inside Postiz once. With the MCP server, codex mcp login signs Codex in over OAuth, so no API key is needed and it only reaches channels you connected. With the CLI skill, authenticate with postiz auth:login or set a POSTIZ_API_KEY environment variable.

Is Postiz free to use with Codex?

Postiz offers a 7-day free trial, and paid plans start at $29 per month. The Codex integration itself, both the skill and the MCP server, costs nothing extra. Codex is provided by OpenAI under your ChatGPT plan or API usage. See the pricing page for current plans.

What can I ask Codex to do in Postiz?

List connected channels, check platform options like Reddit flairs or YouTube playlists, upload images and video, create posts and threads, apply platform-specific settings, schedule or draft campaigns, list and cancel scheduled posts, and pull channel or post analytics. Anything the Postiz CLI or MCP tools can do, Codex can do from a prompt.

Related Postiz guides for AI agents

Postiz Agent CLI

The postiz CLI and skill any AI agent can drive from a shell.

Postiz MCP server

The OAuth MCP endpoint Codex, ChatGPT, Claude, and Cursor connect to.

ChatGPT + Postiz

The chat-app route for OpenAI users who are not in a terminal.

Claude Code + Postiz

The same workflow with Anthropic's terminal coding agent.

Cursor + Postiz

Post from the Cursor editor with the Postiz plugin or skill.

Postiz pricing

7-day free trial, with MCP, CLI and API access on every plan.

Start automating today

Set up Postiz once and let Codex handle your social media posting across every platform — you just ask.