ChatGPT users: the App Store app is behind. For Amazon Ads, ChatGPT Ads, Google Analytics, and Google Search Console, add Adspirer as a custom connector — it takes two minutes. How →
ChatGPT users: the App Store app is behind. For Amazon Ads, ChatGPT Ads, Google Analytics, and Google Search Console, add Adspirer as a custom connector — it takes two minutes. How →
Install Adspirer in Codex inside the ChatGPT desktop app — three chat messages, no terminal. Manage Google, Meta, Amazon, ChatGPT, LinkedIn, and TikTok Ads with 400+ tools.
The ChatGPT desktop app has Codex built in. Switch to Codex, send three messages, and Adspirer is installed and signed in — no terminal, no config files. You get the same plugin as Codex in the terminal: 400+ ad platform tools and five advertising skills, running in a chat window.
Codex Desktop vs. Codex Terminal. Same plugin, same skills, same Adspirer account. Use the desktop app if you’d rather work in a chat window. Use the terminal setup if you want scheduled, autonomous runs or you already live in a CLI.
Download the app from OpenAI’s desktop app page — it covers macOS, Windows, and Linux. Open it and sign in with your ChatGPT account.Already have it? Make sure it’s up to date. Codex only appears in recent versions.
2
Switch to Codex
Click the dropdown at the top left of the sidebar (it says ChatGPT) and choose Codex. The sidebar switches to Codex’s — New chat, Projects, Plugins, and so on.Click New chat. Codex works inside a folder on your computer. When it asks where to work, pick or create one for your ads work — if you keep brand guidelines or media plans there, the agent reads them.
Codex selected in the top-left dropdown, ready for a new chat
3
Message 1 — add the Adspirer marketplace
Send this as a chat message. Codex runs it for you — if it asks permission to run a command, approve it.
codex plugin marketplace add amekala/ads-mcp
Codex confirms Marketplace is registered successfully, naming it adspirer-marketplace with the source github.com/amekala/ads-mcp.
4
Message 2 — install the plugin
install plugin
Codex confirms Installed and verified — adspirer-ads-agent@adspirer-marketplace.
Messages 1 and 2 — marketplace registered, plugin installed
5
Message 3 — sign in to Adspirer
help me oauth it
Your browser opens Adspirer’s login page. Sign in (or create an account), click Authorize, and link the ad platforms you want to manage. Back in Codex you’ll see Adspirer OAuth is complete and verified, with the endpoint https://mcp.adspirer.com/mcp and status enabled.
Message 3 — OAuth complete, Adspirer enabled
6
Start a new chat and check your connections
The plugin loads in your next task, so click New chat and ask:
Check my connected ad platforms
You should see a table of your connected accounts with account IDs, names, and connection status.
7
Try It Now
Sign up for Adspirer — free to start
15 free tool calls/month. No credit card required. Connect your ad accounts in 2 minutes.
You’re connected. Codex in the desktop app now has Adspirer’s 400+ advertising tools and five skills — the same plugin as the terminal setup.
With Computer use on, Codex can work inside your other apps, not just call Adspirer’s tools: open Ads Manager or Merchant Center in Chrome to check something the API doesn’t expose, read a budget sheet in Excel, or drop a report into one. Codex asks before it touches an app, and you can set Always allow per app once you trust it.
1
Turn on Computer use
In the ChatGPT desktop app, open Settings → Computer use and switch on the apps you want Codex to reach: Any App, Google Chrome (it installs a browser extension — Manage shows whether it’s in), and Microsoft Excel. Leave Locked use off unless you want tasks to keep running while your Mac is locked.
Settings → Computer use — Any App, Google Chrome, and Microsoft Excel switched on
On macOS the app asks for Screen Recording and Accessibility permissions the first time — grant both, or Computer use can’t see or click anything. Available on macOS and Windows.
2
Turn on Computer history (macOS)
Open Settings → Integrations → Computer history and click Turn on. Codex turns your recent activity into memories it can use, so “pick up where I left off on the Q4 budget” means something. Use Permissions → Choose to keep apps and sites you’d rather not share — your bank, your inbox — out of it.
Settings → Computer history, with Permissions for including or excluding apps and websites
It needs Memories turned on, it’s off by default, and on Business and Enterprise plans an admin has to allow it before you’ll see the switch.
Adspirer’s safety rails — campaigns created paused, budget changes confirmed first — apply to its tools, not to clicks Codex makes in a browser. When a task touches an ad platform’s web UI, leave Chrome on ask-each-time rather than Always allow, and let the Adspirer plugin do the writes.
The Prompt Engineering Playbook generates an Expert Kit from one of your ad accounts: an agent with account-specific instructions, a skill, a prompt book graded Beginner → Expert, and reference files on the account and on working with Adspirer. It’s a paid add-on (included on annual plans) — pricing and what’s inside are on that page. On Codex Desktop you don’t copy files anywhere: you hand the folder to Codex.
1
Download the kit
Go to adspirer.ai/expert-space, open the kit for the account, and click Download kit (.zip). Unzip it — you get one folder, named like google-ads-expert-<brand>/, containing:
In a Codex chat inside your ads project folder, attach the unzipped folder (click + in the composer, or drag the folder in) and send:
Install this kit's contents and instructions for this project
Codex installs the kit into the project: the skill goes where Codex loads skills from, the agent definition registers your account’s expert, and every file is checked against the download. It keeps AGENTS.md inside the skill rather than at the project root, so it doesn’t override instructions you already have. Your Adspirer sign-in is untouched.
3
Start a new task with the expert
Codex ends with a link to the new agent — click it, or start a New chat and ask for the expert by name. From here the agent knows your account’s structure, spend history, and operating doctrine. Open PROMPTBOOK.md for prompts written against your real campaigns.
Both connect to the same Adspirer account, so you can install in both and switch freely. The Codex Terminal guide covers scheduled runs, agent configuration, and the manual install.
The plugin also brings five skills — campaign management, brand workspace setup, performance review, ad copy, and wasted spend. You don’t need to name them; describe what you want and Codex picks the right one. The skill reference is on the terminal page.
No. Codex is built into the ChatGPT desktop app. The three messages above are all the setup there is — Codex runs the underlying commands for you.
Is this the same plugin as the terminal install?
Yes. Both install adspirer-ads-agent from the Adspirer marketplace: the same 400+ tools, the same five skills, the same brand-workspace behavior. If you later want scheduled, autonomous runs, follow the Codex Terminal guide — your Adspirer sign-in carries over.
Can I also use the Adspirer app in ChatGPT itself?
Yes. The ChatGPT app and Codex Desktop use the same Adspirer account and the same tool-call quota. Use ChatGPT for quick questions and interactive dashboards; use Codex when you want the agent to work through a multi-step task in your folder.
What does Codex do with the folder I pick?
It treats the folder as your brand workspace. On first use the plugin scans it for brand docs — guidelines, media plans, briefs — pulls live campaign data, and writes an AGENTS.md with what it learned, so later chats start with context. An empty folder works too; the agent builds the workspace from your ad accounts.
Can the agent spend money on its own?
No. Every campaign is created paused, and budget changes need your confirmation. The agent analyzes, recommends, and drafts — you approve spend.
How much does this cost?
Adspirer pricing is based on tool calls, not ad spend. Free tier: 15 calls/month. Plus: 49/mofor150calls.Pro:99/mo for 600 calls. Max: $199/mo for 3,000 calls. See full pricing.
