Add SuperEbook to Codex. In the terminal, your editor and the ChatGPT desktop app.

• A SuperEbook account with Starter, Pro or any credit pack. SuperEbook’s Free plan doesn’t include connecting apps: see plans.
• Codex, signed in: the Codex CLI (run codex and choose Sign in with ChatGPT, or another sign-in), or the Codex extension in VS Code, Cursor or Windsurf.
• A browser on the same computer to sign in. Without one, such as over SSH, use an API key instead.

1. 1

   Add the server.

   Codex saves it to ~/.codex/config.toml, finds that SuperEbook supports signing in, and opens your browser. Keep the www.

   Copy Codex command

   codex mcp add superebook --url https://www.superebook.ai/api/mcp

2. 2

   Allow it on SuperEbook.

   Sign in to SuperEbook if it asks. SuperEbook’s page asks “Connect Codex to SuperEbook?”, with no warning, because the app comes back to your own computer. Choose Allow.

3. 3

   Sign in again later with codex mcp login.

   If the browser didn’t open, or the sign-in has run out, run codex mcp login superebook.

4. 4

   Check it.

   codex mcp list shows it, and so does /mcp inside codex. Then ask Codex to plan a book.

The entry it writes is just the address:

[mcp_servers.superebook]
url = "https://www.superebook.ai/api/mcp"

For a computer with no browser to sign in from. The key stays in an environment variable; the file holds only its name.

1. 1

   Create an API key.

   In SuperEbook, open Settings → Connect apps and choose Create API key. Name it after Codex, then copy it: you see the whole key only once, and it starts ebk_live_. It needs a verified email address.

2. 2

   Set it in the shell you start Codex from.

   In your shell profile, for example. Replace ebk_live_YOUR_KEY with your key.

   Copy environment variable

   export SUPEREBOOK_API_KEY="ebk_live_YOUR_KEY"

3. 3

   Add the server with the variable’s name.

   In ~/.codex/config.toml, use this entry instead of the one above; one table per server name. Codex sends the key as Authorization: Bearer ….

   Copy Codex config.toml entry with a key

   [mcp_servers.superebook]
   url = "https://www.superebook.ai/api/mcp"
   bearer_token_env_var = "SUPEREBOOK_API_KEY"

Or the same from the command line:

codex mcp add superebook --url https://www.superebook.ai/api/mcp --bearer-token-env-var SUPEREBOOK_API_KEY

If you added it above, there’s nothing more to do: the ChatGPT desktop app, the Codex CLI and the IDE extension share this configuration, so SuperEbook is already there.

1. 1

   Or add it from the extension.

   Open the gear menu, choose MCP servers, then Add server. Name it superebook, choose Streamable HTTP and enter https://www.superebook.ai/api/mcp. Save, choose Restart extension, then Authenticate when the list shows the server needs a sign-in.

codex mcp logout superebook removes the sign-in Codex kept, and codex mcp remove superebook removes the server. To end the connection on SuperEbook’s side at once, disconnect Codex in Settings → Connect apps.

Once it’s connected, ask for a book in plain words. Planning is free, and the app is told to quote the price and wait for your yes before it writes.

• “Read notes/talk.md and use SuperEbook to plan a lead magnet from it. Show me the plan first.”
• “Turn the README’s setup section into a SuperEbook how-to guide.”
• “What would a workbook cost in SuperEbook credits?”
• “Is my book written yet?”

Codex says the server may or may not require login

Run codex mcp login superebook to sign in.

Sign-in fails after choosing CIMD

SuperEbook doesn’t offer a client metadata document. Leave --oauth-client-registration out (the default, auto, registers dynamically), or pass dcr.

SuperEbook refuses the key

Check that SUPEREBOOK_API_KEY is set in the environment Codex starts from. An editor opened from the Dock or Start menu may not see what your shell profile sets: start it from a terminal, or sign in instead.

For credits, limits and the other messages an app may relay, see if something goes wrong.

• How connecting works
• Credits and limits
• What an app can see
• Claude app
• ChatGPT
• Grok
• Perplexity
• Le Chat
• Claude Code
• Cursor
• VS Code
• GitHub Copilot
• Gemini CLI
• Zed
• Devin Desktop
• Other apps