Install Ads in Codex

What you need first

  • Codex, installed.
  • Node.js, which gives the npx command the server starts with.
  • Your own values for YOUR_GOOGLE_ADS_CLIENT_ID,YOUR_GOOGLE_ADS_CLIENT_SECRET,YOUR_GOOGLE_ADS_DEVELOPER_TOKEN,YOUR_GOOGLE_ADS_REFRESH_TOKEN,YOUR_GOOGLE_ADS_CUSTOMER_ID,YOUR_META_APP_ID,YOUR_META_APP_SECRET,YOUR_META_ACCESS_TOKEN,YOUR_META_AD_ACCOUNT_ID.

Steps

  1. Run this in a terminal. It writes the server into ~/.codex/config.toml, which the Codex CLI, its IDE extension and the ChatGPT desktop app share.
codex mcp add ads-mcp --env GOOGLE_ADS_CLIENT_ID=YOUR_GOOGLE_ADS_CLIENT_ID --env GOOGLE_ADS_CLIENT_SECRET=YOUR_GOOGLE_ADS_CLIENT_SECRET --env GOOGLE_ADS_DEVELOPER_TOKEN=YOUR_GOOGLE_ADS_DEVELOPER_TOKEN --env GOOGLE_ADS_REFRESH_TOKEN=YOUR_GOOGLE_ADS_REFRESH_TOKEN --env GOOGLE_ADS_CUSTOMER_ID=YOUR_GOOGLE_ADS_CUSTOMER_ID --env META_APP_ID=YOUR_META_APP_ID --env META_APP_SECRET=YOUR_META_APP_SECRET --env META_ACCESS_TOKEN=YOUR_META_ACCESS_TOKEN --env META_AD_ACCOUNT_ID=YOUR_META_AD_ACCOUNT_ID -- npx -y @gudlab/[email protected]
  1. Replace YOUR_GOOGLE_ADS_CLIENT_ID,YOUR_GOOGLE_ADS_CLIENT_SECRET,YOUR_GOOGLE_ADS_DEVELOPER_TOKEN,YOUR_GOOGLE_ADS_REFRESH_TOKEN,YOUR_GOOGLE_ADS_CUSTOMER_ID,YOUR_META_APP_ID,YOUR_META_APP_SECRET,YOUR_META_ACCESS_TOKEN,YOUR_META_AD_ACCOUNT_ID with your own values.
  2. Start Codex again and type /mcp: the server is listed.

Check it worked

Ask Codex: List the tools of ads-mcp.

If it does not start

spawn npx ENOENT
Node.js is not on the PATH that Codex sees. Install it, or write the full path of npx in the config.
The server starts, but its tools fail
A YOUR_… placeholder is still in the config, or its value is wrong.

Back to Ads