Codex + Medium

Post to Medium from Codex

Connect Codex to PostDelegate once, then ask it for Medium posts from the Codex CLI or IDE extension. Ask for a draft and it waits on your calendar until you schedule it.

Codex drafts it. You approve it. PostDelegate posts it.Medium: Markdown stories, on your profile or a publication.

How to post to Medium from Codex

  1. Add PostDelegate to Codex. Add the server to ~/.codex/config.toml as below. Run codex mcp login postdelegate and sign in in your browser.

    ~/.codex/config.toml

    [mcp_servers.postdelegate]
    url = "https://app.postdelegate.com/mcp-oauth-dynamic"
  2. Connect Medium in PostDelegate. Create one from your Medium security settings, if your account still offers them. Medium decides who can create tokens and owns that screen. If your account cannot create one, the connection cannot be made.
  3. Ask Codex for a draft. Describe the post in plain words. Codex checks your Medium channel's rules, creates the post and sends back a preview link.

Teach Codex the posting rules

Add PostDelegate’s AGENTS.md to your repository, so Codex knows the MCP tools, the REST API and the safety rules when it works there. Agent files has the steps.

What to ask Codex

Mention any Medium setting in plain words and Codex fills it in. Codex can also read text files in your project, such as a changelog or a draft in Markdown.

  • Draft a Medium story with a title and a subtitle from this outline, with a canonical URL to the original post.
  • Schedule the story for Thursday at 8:00 in our publication, with up to four tags.
  • Cross-post blog/2026-11-launch.md to Medium with the canonical URL set to our blog, as a draft.

What Codex can do on your Medium channel

  • Check the rules first. Before writing, it reads your Medium channel's length limit and required settings.
  • Draft, schedule or post. It creates a draft, a scheduled post or an immediate post, and runs the same checks as the app.
  • Use your media. It attaches files from your media library or adds one from a public link.
  • Review and fix. It lists what is scheduled, changes the Medium settings of a post that has not gone out, and deletes posts you no longer want.

A Medium story needs a title and a subtitle, and PostDelegate asks for both so a scheduled story is never missing one. The body is written in Markdown, up to 100,000 characters, with optional tags (up to four) and an optional canonical URL for stories that first appeared elsewhere.

Medium settings Codex can fill in

SettingNotes
TitleRequired, at least 2 characters.
SubtitleRequired, at least 2 characters.
Canonical URLOptional. Use it when the story first appeared elsewhere.
PublicationOptional. Choose one of the publications you can post to.
TagsOptional, up to 4.

Before you start

  • The connection needs a Medium integration token. Medium decides who can create tokens, so some accounts cannot connect.
  • A story sent to a publication arrives as a draft for an editor, not as a published story.

The Medium channel guide has every field, and MCP tools lists exactly what an assistant can and cannot do.

Questions

Will Codex publish to Medium without asking me?
Not unless you ask it to. Ask for a draft and the post waits on your calendar until you schedule it, and your workspace's approvals apply as usual. Tools that change data are marked as such, so Codex can ask you before it schedules or deletes anything.
Do I need an API key to connect Codex?
No. Codex signs in with your PostDelegate account through your browser. An API key is only for clients that cannot sign in, as described in MCP clients.
Does it cost extra to use Codex with PostDelegate?
No. The MCP server is on every plan, and Codex runs on your own Codex account, so PostDelegate never charges for AI. Every plan starts with a 7-day free trial with no card.
Can Codex attach images or video to a Medium post?
It can use files already in your media library, or add one from a public link. It cannot fetch files from your computer, so upload those in the app first. See MCP tools.
Do I need a Medium integration token?
Yes. PostDelegate connects to Medium with an integration token from your Medium security settings. Medium decides who can create tokens and owns that screen. If your account cannot create one, the connection cannot be made.
Does a scheduled Medium story go live or stay a draft?
It depends on the Publication setting. With no publication selected, the story is published publicly on your profile. With a publication selected, it is sent to the publication as a draft so an editor can review it.

Medium from other assistants

Other networks from Codex

Prefer to plan Medium posts yourself? See the Medium scheduler.

Try it for 7 days

Your next great post starts here.

Give your ideas a home. Plan your content, find your rhythm, and bring your social channels together.

Start your 7-day free trial

No credit card required

Add a card before the trial ends to keep your plan.