How to post to LinkedIn from OpenAI Codex

Set it up and post, step by step

Prompt to copy once LinkedIn is connected: Read CHANGELOG.md and write a first-person LinkedIn post about what we shipped in v3.1 and why, with the release link in the first comment. Show it to me, then schedule it for Tuesday at 8:30 my time.

1. Add PostWire to Codex

   In your terminal run codex mcp add postwire --url https://postwire.io/api/mcp, then codex mcp login postwire. The browser opens PostWire's sign-in, which asks for your email and a 6-digit code and creates a free PostWire account if you have none: no password and no card. codex mcp list, or /mcp inside Codex, shows postwire with its tools. The entry lands in ~/.codex/config.toml, which the Codex CLI, the IDE extension and the ChatGPT desktop app share, so one setup posts to LinkedIn from any of them.

2. On a server or in CI, sign in another way

   codex mcp login postwire --no-browser gives you a sign-in link to open on any device. In CI, give Codex your key instead: copy it in the dashboard under API & MCP, set POSTWIRE_API_KEY, and put the variable's name in ~/.codex/config.toml, never the key itself:

   [mcp_servers.postwire]
   url = "https://postwire.io/api/mcp"
   bearer_token_env_var = "POSTWIRE_API_KEY"

3. Connect your LinkedIn profile

   Ask "connect my LinkedIn". Codex calls create_connect_link and prints a one-hour link; open it, sign in on LinkedIn's own page and press Allow. PostWire asks LinkedIn only for permission to post as you (w_member_social), plus your name and photo to show which profile is connected.

4. Ask for the post

   "Write the LinkedIn post for the release." generate_posts returns a draft and publishes nothing. It is written for LinkedIn: first person, 1,200 to 1,500 characters when the idea allows, the hook in the first 210 characters (about two lines, what the feed shows before "see more"), very short blocks, 3 hashtags at the end. A link goes in the first comment, not in the body, because a link in the body costs reach. Ask for changes in plain words until it reads right.

5. Add images or a PDF from the repo, if you want them

   Up to 20 images in one post, or one PDF, PowerPoint or Word file on its own, which LinkedIn shows as a document readers swipe through. LinkedIn fetches files from a link, so a file on your disk goes through an upload page: Codex asks for one (create_upload_link, valid 24 hours, up to 100 MB on the free plan and 1 GB on paid plans), you pick the files there, and get_uploaded_file hands Codex their links. A file that is already online goes as its public https link.

6. Publish now, or schedule it

   Say "post it" and Codex calls post_to_social; the result carries the link to the live post and the first comment's status. Say "schedule it for Tuesday at 8:30" and it calls schedule_post, or uses run_at: "next_slot" for your next free posting hour. This is the call:

   {
     "name": "schedule_post",
     "arguments": {
       "platforms": ["linkedin"],
       "per_platform": { "linkedin": {
         "text": "We shipped CSV export for invoices this week.\n\nIt took three tries. …\n\n#buildinpublic #saas #devtools",
         "first_comment": "The release notes: https://example.com/changelog/v3-1"
       } },
       "run_at": "2026-11-10T08:30:00-05:00"
     }
   }

7. Check the queue

   "What's scheduled on LinkedIn?" calls list_scheduled_posts and "cancel Tuesday's post" calls cancel_scheduled_post; the same queue is on the dashboard's Queue page.

From a release script, codex exec "write the LinkedIn post for the latest tag from CHANGELOG.md and schedule it for 8:30 tomorrow" runs the same request without the interactive screen. Prefer to set it up by hand? Open the dashboard, connect LinkedIn under Accounts and copy your key under API & MCP.