Integrations / Codex / Setup guide
Set up Adneuron in Codex
Connect Adneuron to Codex and pull your Google Ads and Meta Ads performance into your terminal or editor. One command adds Adneuron and signs you in with your Adneuron account; no API key is needed.
Last updated November 7, 2026
Before you begin
You need
- An Adneuron account (the free plan works) with a Google Ads, Meta Ads, LinkedIn Ads or Amazon Ads account connected and synced.
- The Codex CLI, the Codex IDE extension or the ChatGPT desktop app. They share one settings file,
~/.codex/config.toml, so adding Adneuron once works in all three.
No Adneuron account yet? Create one free.
Connect Adneuron
- 1
Add Adneuron
Run this in your terminal:Codex finds Adneuron's sign-in and opens the Adneuron sign-in page in your browser.Terminalcodex mcp add adneuron --url https://mcp.adneuron.ai/mcp - 2
Sign in to Adneuron
Sign in, choose the workspace Codex should use, review the access requested and click Allow. The terminal then says Successfully logged in. If no browser opened, run:Terminalcodex mcp login adneuron - 3
Check it
Runcodex mcp list, or type/mcpinside Codex, to see Adneuron among your servers.
~/.codex/config.toml, then run codex mcp login adneuron:[mcp_servers.adneuron]
url = "https://mcp.adneuron.ai/mcp"codex mcp login adneuron --no-browser, open the link it prints on another device, then paste the full address you are sent back to into the terminal.Connector details
- Name
- Adneuron
- Server URL
- https://mcp.adneuron.ai/mcp
- Sign-in
- OAuth with your Adneuron account (Codex registers itself)
- Transport
- Streamable HTTP (the default)
Test the connection
Start Codex and send:
List my connected Adneuron ad accounts.You should see your connected Google Ads (and Meta Ads) accounts. If Codex asks to use an Adneuron tool, allow it. If it answers without using Adneuron, see Troubleshooting.
What you can do
Once connected, Codex can use Adneuron to:
| Accounts and connections | List your connected ad accounts and the Google Ads accounts your sign-in can access, check connection health, and get a link to connect an ad account. |
|---|---|
| Performance | Spend, clicks, impressions and results for 7, 30, 60 or 90 days, per account and in total, with the dates and currency used. |
| Campaigns | Rank campaigns by spend, clicks, conversions or ROAS, and compare Google Ads with Meta Ads. |
| Cost per result | Rank campaigns, ad sets and ads by cost per result, such as cost per install, lead or purchase, against your target or your own 90-day average. |
| Catalog products | See how Meta catalog products and product sets are doing, where shoppers drop off, and which products spend without selling, when Meta reports it. |
| Changes over time | Explain why a metric moved, comparing the latest period with the one before. |
| Budgets | Review every budget across accounts, including shared budgets, and which campaigns each one funds. |
| Waste and connection health | Find campaigns spending without results and check the token status and last sync of your connected ad platforms. |
| Planning | Research keywords, get conservative, moderate and aggressive budget options for a keyword set, and pick a Google Ads campaign type (needs a connected Google Ads account). |
| Your Adneuron account | Check plan limits and usage, and read your saved brand profile. |
Meta conversions, leads and ROAS are reported as unavailable rather than zero while Adneuron verifies them. Reports cover complete days in each ad account's own time zone and currency, and say which dates they cover.
Example prompts
"How did my ads do in the last 30 days?"
Spend, clicks, results and dates per account
"Which campaigns got the most clicks last month?"
Campaign ranking for the same dates
"Compare Google Ads and Meta Ads for the last 7 days."
Platforms side by side
"Where am I wasting ad spend?"
Campaigns spending without results
How changes work
Troubleshooting and FAQ
›Codex says Adneuron needs sign-in
codex mcp login adneuron again. Sign-in lasts until you disconnect or Adneuron access is cleared.›Codex answers without using Adneuron
/mcp that Adneuron is listed and signed in.›Codex sees no ad accounts
›The monthly limit is reached
›Can I use Adneuron with more than one client workspace?
Disconnect
To stop Codex using Adneuron, delete the [mcp_servers.adneuron] section from ~/.codex/config.toml, or add enabled = false under it to keep it switched off. To stop Adneuron reading an ad account, disconnect that account in the Adneuron dashboard.
Privacy and support
Codex receives an access token for the one workspace you chose and the results of the Adneuron tools it calls. Adneuron never receives your Google or Facebook password. See the Privacy Policy for what we store and how to request deletion. Need help? Visit Support or email support@adneuron.ai with your workspace name; never send passwords, API keys or access tokens.
Sources
These steps follow Codex's own documentation, checked on November 7, 2026. Menu names can change; if a step looks different, tell us.