OpenAI Codex

OpenAI Codex is OpenAI’s CLI agent for software development. You can connect it to Kavio’s MCP server to manage your social media scheduling with natural language.

Prerequisites

Codex CLI installed (npm install -g @openai/codex)
A Kavio account with an active trial or subscription (no card required to start)

Setup

Open the configuration file

Edit ~/.codex/config.toml and add the Kavio server:

[mcp_servers.kavio]
type = "http"
url = "https://app.getkavio.app/mcp/kavio"

No Authorization header — Codex discovers OAuth from the URL.

Run the OAuth flow so Codex caches the token:

codex mcp login kavio

Codex opens your browser to Kavio; approve the request and return to the terminal.

Verify the connection

Start Codex and ask:

List all my Kavio posts

Codex uses TOML for configuration (not JSON). For sandboxed environments where the default callback port isn’t reachable, set mcp_oauth_callback_port or mcp_oauth_callback_url in config.toml.

Bearer token fallback

For headless environments, use a Personal Access Token via environment variable:

export KAVIO_API_KEY="YOUR_API_KEY"

[mcp_servers.kavio]
type = "http"
url = "https://app.getkavio.app/mcp/kavio"
bearer_token_env_var = "KAVIO_API_KEY"

Create the key from Settings > API Keys on the Kavio dashboard. bearer_token_env_var keeps the token out of the config file.

Example prompts

Create a new draft post for all my social accounts

Show me all my signatures

Create a label called "Campaign" with color #f59e0b

Getting Started

Setup Guides

Prerequisites

Setup

Example prompts

​Prerequisites

​Setup

​Example prompts

Prerequisites

Setup

Example prompts