Schedule X posts from Codex CLI
Add Hookpost to Codex CLI as a remote MCP server in ~/.codex/config.toml, with your API key in an environment variable. Then ask it for a X post: it saves a draft, schedules it, or publishes it now to your X account. If X is not connected yet, it gives you a link that connects it in about a minute.
By the Hookpost team ·
Set it up in 3 steps
- Copy your Hookpost API key. In Hookpost, open Settings → Developers → Reveal → Copy.
- Add the server. Add the table below to ~/.codex/config.toml and export HOOKPOST_API_KEY with your key.
- Connect X. Ask Codex CLI to connect X. It replies with a link; open it, approve on X's screen, and the channel is in Hookpost. You can also use Add Channel in the app.
~/.codex/config.toml
# ~/.codex/config.toml [mcp_servers.hookpost] url = "https://hookpost.hookstep.in/api/mcp" bearer_token_env_var = "HOOKPOST_API_KEY"
Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI and the hookpost CLI use an API key, which comes with the Hookpost plan.
What X accepts
Text limit: 280 characters (4,000 on a Premium account). Codex CLI reads these from get_platform_post_rules before it writes, so the draft fits.
- Threads supported
- Articles accept images only
A first prompt
Paste this into Codex CLI. It stops at a draft, so nothing goes out until you look at it.
Prompt
List my Hookpost channels. If X is not connected, give me the link to connect it and wait. Then write a three-post X thread, based on CHANGELOG.md, within X's limits. Save it as a draft in Hookpost. Do not schedule or publish anything.
What happens behind it
- list_channels finds your X channel and its id.
- If there is none, create_channel_connect_link returns a link: you open it, approve on X's own screen, and the channel is added. The link works for 24 hours.
- get_platform_post_rules returns X's limit and the settings a post takes.
- create_post saves the post as a draft, schedules it for a time, or publishes it now.
Questions
- Can Codex CLI post to X on its own?
- Yes, through Hookpost's create_post tool: as a draft, at a scheduled time, or right away. It posts to your X account only after you have connected it, and the prompt above keeps it to drafts until you review them in the Hookpost calendar.
- Do I need my own X developer app or API key?
- No. Hookpost holds the X app; you approve Hookpost once on X's sign-in screen, from the link Codex CLI gives you or from Add Channel.
- What does it need on the Hookpost side?
- Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI and the hookpost CLI use an API key, which comes with the Hookpost plan.
- What can Codex CLI not do in Hookpost?
- Delete posts, edit the text or date of a post, or read analytics. Do those in the Hookpost app.
Related
- X in Hookpost
Everything Hookpost does on X.
- Full Codex CLI setup
Every option for Codex CLI, step by step.
- Every agent and network
The other agents and networks.
- The Hookpost MCP server
Endpoints and the full tool list.