Octopost + OpenAI Codex CLI

Octopost is a social media MCP server. Add it to OpenAI Codex CLI and your agent can post to X, Bluesky, Mastodon and LinkedIn, write threads, schedule posts and hold them for your approval. Other networks are on the roadmap.

  1. 1. Start a plan and connect X

    Sign up (7 days for $1, then $29 a month), then connect your X account on the accounts page.

  2. 2. Add Octopost to OpenAI Codex CLI and sign in

    Run these in your terminal (they write ~/.codex/config.toml):

    codex mcp add octopost --url https://octopost.ink/mcp
    codex mcp login octopost
    1. Run codex mcp add, then codex mcp login octopost.
    2. An Octopost page opens: sign in if asked, check the account, and click Allow.
    3. Start a new Codex session; /mcp lists the server.

    No key to copy: OpenAI Codex CLI signs in to Octopost (OAuth) and stays connected.

    Or with an API key, in ~/.codex/config.toml:

    [mcp_servers.octopost]
    url = "https://octopost.ink/mcp"
    http_headers = { "Authorization" = "Bearer op_YOUR_API_KEY" }

    Keys are on the API keys page.

  3. 3. Try it

    Ask your agent:

    • “List my Octopost accounts.”
    • “Queue a post to X about today's release and hold it for my approval.”
    • “Turn these release notes into a 3-post X thread and schedule it for 9am tomorrow.”

If it doesn't connect

  • The sign-in window didn't open, or it says the app isn't registered: remove the Octopost connector and add the URL again.
  • 401 Unauthorized with a key: the key is missing, mistyped, revoked, or not sent as Authorization: Bearer op_.... The error message names which.
  • “Your Octopost plan is not active”: finish the $1 trial checkout on the billing page.
  • “No twitter account connected”: connect X on the accounts page.

Still stuck? Email hello@greatwork.company; a person answers.

Other clients

Any other MCP client: add https://octopost.ink/mcp as a remote (Streamable HTTP) server and sign in, or send Authorization: Bearer op_.... Full reference: MCP docs.