Setup guide · OpenAI Codex CLI

Google Ads Codex MCP

Add AdsAgent to OpenAI's Codex CLI in under a minute. One terminal command wires up the MCP server and walks you through OAuth — Codex then has live access to your Google Ads account.

Free · No credit card · 1-minute setup

How to install

Add AdsAgent to Codex in 3 steps

Install the Codex CLI

Open a terminal and install OpenAI Codex if you don't have it already. Follow the official install guide for your platform.

Add the AdsAgent MCP

Run this one-liner. Codex will walk you through the OAuth flow and register the AdsAgent MCP server automatically.

codex mcp add adsagent --url https://adsagent.org/api/mcp

Ask Codex about your ads

Try a prompt like:

“Audit my connected Google Ads account and tell me the 3 biggest optimization opportunities.”

Codex will call AdsAgent tools to read your account and respond with specific, data-backed insights.

Ready to wire up Codex?

Sign in with Google to set up your AdsAgent account, then run the one-liner in your terminal. Setup takes under a minute.

Or use Claude Code instead

FAQ — AdsAgent for Codex

Everything you need to know about installing and using the AdsAgent MCP inside OpenAI's Codex CLI.

What is the AdsAgent Codex MCP integration?

It's an MCP (Model Context Protocol) integration for OpenAI's Codex CLI. Once added, Codex can read your Google Ads campaigns, keywords, search terms, spend, and ad copy in real time — and propose changes you approve in chat.

How is this different from the Claude setup guides?

Same backend, different client. The Codex CLI calls the AdsAgent MCP server using OpenAI's MCP support. The Claude Connector and Claude Code plugin call the same server from Anthropic's clients. Capabilities are identical.

How long does setup take?

Under a minute. Run a single `codex mcp add adsagent --url https://adsagent.org/api/mcp` command in your terminal — Codex walks you through the OAuth flow and registers the MCP automatically.

Do I need to write any code?

No. One terminal command sets everything up. There are no JSON config edits, no environment variables, and no scripts to run.

Is the integration free?

Yes. Adding AdsAgent to Codex and running a free Google Ads audit is free with no credit card. Paid plans unlock higher usage limits and team features.

Can Codex actually change my Google Ads account?

Only with your explicit approval. Codex can propose pausing campaigns, adjusting bids, adding negative keywords, or writing new ads — but every write action is shown to you first and requires confirmation. Read access is unrestricted; write access is gated.

Related guides

Explore the rest of the AdsAgent setup options.