> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usequotable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

> Add the Quotable MCP server to Codex with one command and sign in with OAuth, or send an API key from an environment variable.

Codex connects to remote MCP servers over Streamable HTTP, in the CLI, the IDE extension and the Codex app. You can sign in to Quotable with OAuth, which needs no key, or send an API key in a header.

## Before you start

* Codex installed and signed in.
* For OAuth: the owner or an integration admin role in your Quotable workspace, to approve the connection.
* For an API key: a key from **Settings → API keys**. See [Authentication](https://docs.usequotable.com/mcp-server/authentication.md) for the scopes each tool needs.

## Add the server

> [tab] Sign in with OAuth
>
> Add the server:
>
> ```bash theme={"system"}
> codex mcp add quotable --url https://app.usequotable.com/api/mcp
> ```
>
> Then sign in:
>
> ```bash theme={"system"}
> codex mcp login quotable
> ```
>
> Your browser opens a Quotable page. Sign in if asked, pick the workspace, the data and the brands, and click **Allow access**. In the Codex app or the IDE extension, choose **Authenticate** next to the server instead.

> [tab] API key
>
> Store the key in an environment variable Codex can see:
>
> ```bash theme={"system"}
> export QUOTABLE_API_KEY="quotable_live_…"
> ```
>
> Add a `quotable` entry to `~/.codex/config.toml`, or to `.codex/config.toml` in a trusted project:
>
> ```toml config.toml theme={"system"}
> [mcp_servers.quotable]
> url = "https://app.usequotable.com/api/mcp"
> bearer_token_env_var = "QUOTABLE_API_KEY"
> ```
>
> Codex reads the key from the variable and sends it as `Authorization: Bearer …`.

## Check the connection

Run `codex mcp list`, or type `/mcp` in Codex. Quotable should be listed with its tools.

## Try it

```text theme={"system"}
Using Quotable, list my brands, then show the visibility score for the first one over the last 30 days.
```

Every Quotable tool reads data except `run_agent`, which starts an agent run and uses your workspace's credits.

## Disconnect

Delete the `quotable` entry from your Codex `config.toml`, or click **Disconnect** next to Codex under **Connected apps** in Quotable's **Settings → MCP**. For an API key, revoke it in **Settings → API keys**.

> [!WARNING]
>
> Don't put an API key in the server URL. Quotable reads credentials only from the `Authorization` header.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.