Skip to content
SPREVA

SPREVA opens soon.

Join the waitlist and we'll email you once, when your account is ready.

No newsletter. Just one email when SPREVA opens.

AI Agents

Codex

OpenAI's coding agent, in the terminal, in the IDE extension and in the ChatGPT desktop app.

Connects with
Sign in, API key, CLI, Skill
Connector
SPREVA
Plans
Included in ChatGPT Free, Go, Plus, Pro, Business, Enterprise and Edu, or with an OpenAI API key.

Before you start

  • Codex installed and signed in.

Set it up

  1. 1

    Add SPREVA:

    Terminal
    codex mcp add spreva \
  --url https://dev-app.spreva.ai/api/mcp
  2. 2

    Sign in. Your browser opens SPREVA: choose the workspace and click Allow.

    Terminal
    codex mcp login spreva
  3. 3

    Check that it is there. Inside Codex, /mcp lists it too.

    Terminal
    codex mcp list

Also works with

  • API key in a header

    Send a SPREVA API key as a Bearer token, for automation that runs without a person.

    Terminal
    export SPREVA_API_KEY=POST_API_KEY_...
codex mcp add spreva \
  --url https://dev-app.spreva.ai/api/mcp \
  --bearer-token-env-var SPREVA_API_KEY
  • The CLI and the Agent Skill

    Install the spreva command line and its Agent Skill, for agents that work in a terminal.

    Terminal
    export SPREVA_API_KEY=POST_API_KEY_...
npx -y @spreva/cli skill install --target codex
  • The CLI's stdio bridge

    Run spreva mcp as a local MCP server, for apps that only start servers on your machine.

    Terminal
    export SPREVA_API_KEY=POST_API_KEY_...
codex mcp add spreva \
  --env SPREVA_API_KEY=$SPREVA_API_KEY \
  -- npx -y @spreva/cli mcp

Check it works

Start a new conversation and ask:

Ask your agent
What's going out this week on SPREVA?

Codex calls SPREVA's overview tool and answers with the workspace's time zone, what goes out next and anything that needs attention. The first time, Codex may ask you to allow the tool.

Good to know

  • The Codex CLI, the IDE extension and the ChatGPT desktop app share ~/.codex/config.toml, so SPREVA is set up in all three at once.
  • Cloud tasks don't use the servers you add on your machine.

Troubleshooting

Sign-in doesn't start

Run codex mcp login spreva again, and update Codex if it is old.

Something else? Troubleshooting covers sign-in loops, plans, limits and time zones.

Official documentation