Skip to content

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. 1

    Add Adneuron

    Run this in your terminal:
    Terminal
    codex mcp add adneuron --url https://mcp.adneuron.ai/mcp
    Codex finds Adneuron's sign-in and opens the Adneuron sign-in page in your browser.
  2. 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:
    Terminal
    codex mcp login adneuron
  3. 3

    Check it

    Run codex mcp list, or type /mcp inside Codex, to see Adneuron among your servers.
Prefer editing the file? Add this to ~/.codex/config.toml, then run codex mcp login adneuron:
config.toml
[mcp_servers.adneuron]
url = "https://mcp.adneuron.ai/mcp"
On a computer without a browser, run 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:

Prompt
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 connectionsList 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.
PerformanceSpend, clicks, impressions and results for 7, 30, 60 or 90 days, per account and in total, with the dates and currency used.
CampaignsRank campaigns by spend, clicks, conversions or ROAS, and compare Google Ads with Meta Ads.
Cost per resultRank 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 productsSee 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 timeExplain why a metric moved, comparing the latest period with the one before.
BudgetsReview every budget across accounts, including shared budgets, and which campaigns each one funds.
Waste and connection healthFind campaigns spending without results and check the token status and last sync of your connected ad platforms.
PlanningResearch 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 accountCheck 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

Adneuron manages campaigns and budgets, and every change needs your explicit approval before it runs. When you ask Codex for a change that is not available through Adneuron yet, Codex tells you and explains how to make it in Google Ads or Meta Ads Manager.

Troubleshooting and FAQ

›Codex says Adneuron needs sign-in
Run codex mcp login adneuron again. Sign-in lasts until you disconnect or Adneuron access is cleared.
›Codex answers without using Adneuron
Mention Adneuron in your question, and check with /mcp that Adneuron is listed and signed in.
›Codex sees no ad accounts
Connect an account in the Adneuron dashboard and run Sync now. Codex only sees connected, synced accounts in the workspace you chose when you signed in.
›The monthly limit is reached
Your plan's tasks reset at the start of each month, or you can change plans on the Pricing page. Listing accounts, checking connections and checking usage don't count.
›Can I use Adneuron with more than one client workspace?
Codex connects to one Adneuron workspace at a time, the one you choose when you sign in. To switch, disconnect Adneuron and connect again, choosing the other 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.