Codex front door — MCP server

Wraps the Google Ads Gateway Worker as two Codex tools: list_accounts and run_gaql. Holds no Google credentials — just the Worker URL and the shared team token.

Per-laptop setup (each teammate, once)

Logging into the shared ChatGPT/Codex account does not carry this — MCP config is a local file. Each laptop does this once (~30 seconds):

cd <path-to>/google-ads-gateway/mcp
npm install

Then add the server to Codex's config. For Codex CLI, edit ~/.codex/config.toml:

[mcp_servers.google_ads]
command = "node"
args = ["/ABSOLUTE/PATH/TO/google-ads-gateway/mcp/index.js"]
env = { GADS_GATEWAY_URL = "https://google-ads-gateway.<subdomain>.workers.dev", GADS_GATEWAY_TOKEN = "<team token>" }

(For the IDE/desktop Codex, add the same command / args / env in its MCP settings UI.)

Restart Codex. Then in a session:

list my google ads accounts for ACI, pull cost, clicks and conversions by campaign for the last 30 days

Related MCP server: google-ads-mcp-server

Quick local test (without Codex)

GADS_GATEWAY_URL=https://google-ads-gateway.<subdomain>.workers.dev \
GADS_GATEWAY_TOKEN=<team token> \
npx @modelcontextprotocol/inspector node index.js