1Your Heropost link
In Heropost, open Home → Connect your AI tools → Codex CLI and press Copy. You get the ready-made command, with your link inside. The link is the key — no sign-in, no token.
2Where it goes in Codex CLI
Run the command — keep the quotes and the whole link, including https://:
codex mcp add heropost --url "https://mcp.heropost.io/mcp/hp_ag_…"In codex, /mcp shows heropost as connected.
3Try it
Ask Codex CLIUse Heropost to create a draft post for Friday about …
Say use Heropost when you want something saved.
Then open Connect your AI tools → Activity in Heropost. A saved draft shows as create post · 1 action.
Good to know
- Who can connect
- Workspace owners and admins — they’re the ones who see Connect your AI tools.
- How many tools
- Every Heropost plan connects up to 3 AI tools, counted across all your workspaces. Agent Pro connects 10; Agent Agency has no limit. All in use? Remove one in the workspace where it’s connected, under Connect your AI tools → Your tools.
- What it can do
- You choose, in Your tools → Codex CLI → Permissions: drafts are always allowed; publishing, reading the inbox and which accounts are yours to switch. Replying in the inbox is on Agent Pro and Agency.
- The link is the key
- It’s shown once. New link replaces it and the old one stops working instantly; Remove cuts Codex CLI off.
- What it costs
- One action is one post saved or one reply sent. Reading, reporting and the writing itself are free.
- Codex says “relative URL without a base”.
- A placeholder went in instead of your link. Run
codex mcp remove heropost, then add it again with your link. - Your screen looks different?
- Tell support, with a screenshot and any error text. We update this guide from real screenshots.
Last checked: Codex CLI 0.154 in the terminal (Sep 17, 2026), on a real Heropost workspace.