Codex + Postcaly

Post to social media from Codex

Ask Codex to announce what you just built. Add Postcaly with one command, sign in once, and Codex drafts and schedules the posts in your Postcaly calendar.

Available now on every plan

Connects by Sign-in link (MCP)

Use Postcaly today: 14 days free, then from £15.99 a month. Updated

Example
You

Draft an X post about the new export feature we merged today and schedule it for 10:00 tomorrow.

Codex

I've written a 196-character post about CSV export. Postcaly's check passed for X. It's scheduled for 10:00 tomorrow in your Postcaly calendar.

Remote MCP server with sign-in

Connect Codex to Postcaly

  1. 1

    Add the server

    Run the command below in your terminal.

  2. 2

    Sign in and choose permissions

    Codex opens a Postcaly page in your browser (or run codex mcp login postcaly). Pick one workspace and tick what it may do. Publishing straight away is off unless you tick it.

  3. 3

    Ask Codex for posts

    Ask Codex to write about the change you just made. It checks each network's rules and saves drafts or schedules posts.

Commandcodex mcp add postcaly --url https://app.postcaly.com/mcp

Where there is no browser, Codex can read a Postcaly API key from an environment variable (bearer_token_env_var). Create one in Postcaly under Settings, AI agents.

Things you can ask Codex

Plain requests work. Codex does the writing; Postcaly checks each network and keeps the schedule.

  • Read the release notes in CHANGELOG.md and draft an X post and a LinkedIn post for version 2.4.

  • Schedule the launch announcement for 09:00 on Tuesday on X, Bluesky and Threads.

  • List every draft in our Postcaly workspace that has no time yet.

  • Check whether this post fits LinkedIn's rules and save it as a draft.

Where your work already is

Codex can read the changes it just made and turn them into posts, without a copy and paste.

Sign in, no tokens in files

OAuth sign-in keeps keys out of your config and your repository.

Same checks as the app

Each post is checked against the network's rules and your plan's limits before it is saved.

What Codex can do in Postcaly

The same actions as the Postcaly screens, with the same plan limits and network checks. You tick which permissions to give.

Read

Looks, never changes

  • See your workspaceName, time zone, plan and how many posts and channels you have left.
  • List your channelsEvery connected account, and whether any needs reconnecting.
  • Know each network's rulesCharacter limits, media rules and required choices such as a YouTube title.
  • Check a post before savingRuns the same checks as the Postcaly composer, so problems show before anything is scheduled.
  • Find the next free timeYour next posting time with nothing booked.
  • List and open postsPosts in a date range, with each channel's status and any error.

Write

Drafts for a person

  • Save draftsSaves a post for a person to finish or approve.

Schedule

Books a stated time

  • Schedule and move postsBooks a post for a time it states or your next usual time, and moves posts that have not gone out.
  • Change, unschedule or deleteEdits a post that has not gone out, returns it to drafts or deletes it.

Media

Your library

  • Add pictures and videosBrings a picture (up to 8 MB) or video (up to 50 MB) into your media library from a public link, with a description.

Publish now

Only if you allow it

  • Publish straight awayOnly if you tick it when you approve the agent.

Not included: editing or deleting posts that are already live, managing people or billing, and connecting social accounts. Those stay with a person in Postcaly.

You stay in control

You approve it

Codex asks for access, you sign in to Postcaly and choose one workspace and what it may do. Each workspace is approved separately.

Nothing posts by surprise

Posts are only created when you ask. A scheduled post needs a stated time, and publishing straight away is off unless you allow it.

Every post is labelled

Posts made by an agent carry the agent's name in your calendar, and every action is listed under Activity.

Drafts only, if you prefer

Switch on Drafts only for a workspace and everything an agent creates arrives as a draft for your team to check.

Your limits still apply

Your plan's limits and each network's rules apply to every agent, the same as in the Postcaly screens.

Disconnect any time

Remove the agent in Postcaly under Settings, AI agents, and its access stops at once. Removed team members' access stops too.

When Codex works best with Postcaly

Codex works inside your codebase and terminal, so it can read the changelog, the release tag and the docs that a product announcement is based on. Connected to Postcaly, it can turn those into checked, scheduled posts.

It suits teams who want release announcements to come from the same place as the release itself.

What Codex is

Codex is OpenAI's coding agent, available in the terminal, editors and the cloud. It connects to tools through MCP servers listed in its config.toml file, using streamable HTTP for remote servers.

Getting good results from Codex

A few habits make agent-made posts better and safer.

  • Say where and when. "Schedule to LinkedIn and X at 09:00 on Tuesday" works better than "post this soon".
  • Start with drafts. Let the agent save drafts until you are happy with its writing, then give it schedule permission.
  • Give it your voice. Share a few past posts you like, or a short note on tone, before asking for new ones.
  • Check one workspace at a time. Each approval covers one workspace, which keeps clients and brands apart.

What stays with a person

Some things are deliberately left out of the agent connection, because they cannot be undone or need someone's judgement:

  • Connecting or removing social accounts happens in Postcaly, by a person.
  • Editing or deleting posts that are already live stays in Postcaly.
  • Team members, roles and billing are managed in Postcaly settings.

Questions

Is it available now?

Yes, on every Postcaly plan. Any account with a confirmed email address can connect it.

Do I need an API key?

No. Codex signs in through your browser. A Postcaly API key read from an environment variable also works, for machines without a browser.

Which networks can it post to?

The channels connected in your workspace: today YouTube, X, LinkedIn profiles, Threads and Bluesky. Facebook Pages, Instagram, Google Business Profile, TikTok and Pinterest open as each network approves Postcaly.

Will it post without asking me?

No. Codex only creates posts when you ask it to. A scheduled post needs a time it states, everything lands in your Postcaly calendar where you can change or delete it, and publishing straight away stays off unless you allow it when you approve the connection.

Can I use it in CI or on a server?

Yes. Where there is no browser to sign in, create a Postcaly API key under Settings, AI agents, and give it to Codex in an environment variable.

Can Codex use a key instead of signing in?

Yes. Codex can send a Postcaly API key from an environment variable, for machines that cannot sign in. Create the key in Postcaly under Settings, AI agents. Signing in is the recommended route for Codex.

What does it cost?

Nothing extra: agent access is included in every Postcaly plan. Your plan's limits on channels, posts and X posts apply to everything an agent does.

Schedule your first post

14 days free on every plan, then from £15.99 a month. Cancel any time.

Start your free trial