Codex

Add pdf-mcp to Codex, authenticate with OAuth, and use PDF tools from your coding session.

On this page

Connect Codex to the hosted pdf-mcp server. You need Codex CLI installed and a pdf-mcp account.

Add the server

Run this command in your terminal:

Shell

codex mcp add pdf-mcp --url https://api.pdf-mcp.io/mcp

Start OAuth authentication from your terminal:

Shell

codex mcp login pdf-mcp

Sign in to pdf-mcp in the browser, select your workspace, and approve access. Start a new Codex session and use /mcp to check the connection. Codex’s official MCP documentation describes configuration, OAuth, and client registration.

Manual configuration

You can also add this entry to ~/.codex/config.toml, keeping existing settings:

toml

[mcp_servers.pdf-mcp]
url = "https://api.pdf-mcp.io/mcp"

Then run codex mcp login pdf-mcp to authorize it.

API-key alternative

For a setup that uses an API key, store the key in your environment as PDF_MCP_API_KEY and reference it by name:

toml

[mcp_servers.pdf-mcp]
url = "https://api.pdf-mcp.io/mcp"
bearer_token_env_var = "PDF_MCP_API_KEY"

The environment variable must be available to the process that launches Codex. Use either this configuration or the OAuth configuration above. See Authentication to create a key for the intended workspace.

Try it

Use pdf-mcp to create a one-page PDF summarizing this project. Store it and return the browser view link.

Generation uses the connected workspace’s credits. If the server connects but a tool fails, see MCP troubleshooting.