How to connect Google & Meta Ads to the Hermes agent
Two ways, both under ten minutes: the Composio Connect CLI or a Connect MCP config. Below are the exact commands, the OAuth steps, and what Hermes can do once your accounts are wired up.
Built by our community of 2,000 marketers
Free skills and prompts for paid ads and SEO
Templates for Claude, ChatGPT and Perplexity.
Clients we work withClients we
work with
THE QUICK VERSION
Hermes connects to Google Ads and Meta through Composio Connect. Install the Composio CLI, ask Hermes to authenticate, then ask it to connect your ad account and authorize the OAuth prompt. That’s it.
Composio connects through the official Google Ads API and Meta Marketing API over OAuth — the sanctioned path, so connecting won’t get your account flagged. Here’s why that matters for account safety.
What Hermes is, and what you need first
Hermes is a 24/7 autonomous AI agent that runs on your own computer or server. It remembers what it learns and connects to outside apps — Google Ads, Meta, Slack, Notion and hundreds more — through Composio Connect, the layer that handles authentication and the actual API calls. Once your ad accounts are connected, Hermes can pull performance data, reallocate budget, adjust targeting, pause underperformers, and generate fresh creative on your behalf.
Before you start, have these ready:
- Hermes installed on your computer or server.
- A free Composio account at dashboard.composio.dev.
- Admin access to the Google Ads or Meta Ads account you want to connect (you’ll authorize it via OAuth).
Method 1 · Fastest
Connect with the Composio Connect CLI
One install command and a couple of chat prompts. Best for connecting from your own machine.
Install the Composio CLI
Run this in your terminal:
curl -fsSL https://composio.dev/install | bash
Or paste https://composio.dev/hermes straight into your Hermes chat box and it will install automatically.
Authenticate Hermes with Composio
Once the CLI finishes installing, ask Hermes in chat to authenticate with Composio — for example: “Authenticate with Composio.” It handles the handshake for you.
Connect Google Ads or Meta Ads
Ask Hermes to connect the account — or simply ask it to do any ad task and it will connect on demand:
Connect my Google Ads account. Connect my Meta Ads account.
Hermes opens an OAuth prompt. Sign in on Google’s or Meta’s own screen and authorize access — your password never touches the agent.
Confirm, then repeat for the other platform
The connection goes live immediately. Run step 3 again for the second platform so Hermes manages Google Ads and Meta from one place.
Method 2 · Persistent config
Connect with Composio Connect MCP
Prefer a reproducible config — handy for servers and headless deployments? Wire Composio in through your Hermes config file instead.
Grab your Composio credentials
Open dashboard.composio.dev and copy your Connect MCP URL and API key.
Open the Hermes config
nano ~/.hermes/config.yaml
Add the Composio MCP server block
Paste this under your config, dropping in your own API key:
mcp_servers:
composio:
url: "https://connect.composio.dev/mcp"
headers:
x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
connect_timeout: 60
timeout: 180Save with Ctrl + O, Enter, then exit with Ctrl + X.
Restart Hermes and connect
Restart Hermes so it picks up the new config, then ask it to connect Google Ads or Meta Ads. It prompts you to authenticate and authorize — same OAuth flow as the CLI method.
Get a free instant audit
Get a free, instant read on your paid ads or SEO — and fix it right away.
Paid ads audit
- Catch wasted spend & broad-match leaks
- Find account structure gaps
- Rank your quickest wins
- Spot PMax & brand-search overlap
- Check conversion-tracking health
- Benchmark CPC vs your industry
- Catch wasted spend & broad-match leaks
- Find account structure gaps
- Rank your quickest wins
- Spot PMax & brand-search overlap
- Check conversion-tracking health
- Benchmark CPC vs your industry
Free · no credit card · instant
SEO audit
- Find keyword & ranking gaps
- Catch technical SEO issues
- Rank your fastest wins
- Surface thin & duplicate pages
- Check indexing & crawl coverage
- Compare backlinks vs competitors
- Find keyword & ranking gaps
- Catch technical SEO issues
- Rank your fastest wins
- Surface thin & duplicate pages
- Check indexing & crawl coverage
- Compare backlinks vs competitors
Free · no credit card · instant
After you connect
What Hermes can do once Google & Meta are connected
On Google Ads
- ✓Create and manage customer lists
- ✓Add or remove contacts from audience segments
- ✓Retrieve campaign details by ID or name
- ✓Create, update, or remove campaigns and ad groups
- ✓Run Google Ads Query Language (GAQL) searches
- ✓Access every customer account available to you
On Meta Ads
- ✓Automated campaign and ad creation
- ✓Real-time ad performance insights
- ✓Audience management and targeting
- ✓Campaign control and optimization
- ✓Creative asset automation
- ✓Reallocate budget between ad sets
One thing to set up before you let it run
Give Hermes write access to your ad accounts and it can spend money — so keep a human-approval step on budget and bid changes, and review any AI-generated creative against ad policy before it publishes. That’s the difference between an agent that helps and one that gets your account restricted. More on staying ban-safe here.
Don’t want to run an agent yourself?
Hermes is great if you want to self-host. Ryze is the managed version — same official-API safety, no server to maintain, and a human-approval gate built in.
- ✓Official Google + Meta APIs via OAuth
- ✓Nothing to install or keep running
- ✓Approval gate on every budget change
2,000+
Marketers
$500M+
Ad spend
23
Countries
1,000+ marketers use Ryze
Automating hundreds of agencies
★★★★★4.9/5
Frequently asked questions
What is the Hermes agent?
Hermes is a 24/7 autonomous AI agent that runs on your own computer or server. It remembers what it learns and connects to apps — including Google Ads and Meta — through Composio Connect, so it can pull performance, adjust budgets and targeting, pause underperformers, and generate creative on your behalf.
How do I connect Google Ads to Hermes?
Install the Composio CLI with 'curl -fsSL https://composio.dev/install | bash', ask Hermes to authenticate with Composio, then ask it to connect to Google Ads and authorize the OAuth prompt. Or add a Composio MCP server block to ~/.hermes/config.yaml and restart Hermes.
CLI or MCP — which method should I use?
Use the Composio Connect CLI for the fastest setup: one install command and a chat prompt. Use the Connect MCP method for a persistent config in ~/.hermes/config.yaml — handy for servers and reproducible deployments. Both connect through the same official platform APIs.
Will connecting Hermes get my ad account banned?
No. Composio connects Hermes through the official Google Ads API and Meta Marketing API via OAuth — the sanctioned path. Accounts get banned for password sharing, browser automation, or policy-violating ads, not for connecting an agent through the official API. Keep a human-approval step on writes to stay safe.
What can Hermes do with my Google Ads account?
Once connected, Hermes can create and manage customer lists, add or remove contacts from segments, retrieve campaigns by ID or name, create, update, or remove campaigns and ad groups, run GAQL searches, and access every customer account available to you.
Can Hermes manage Google and Meta at the same time?
Yes. Connect each platform once through Composio and Hermes runs both from a single agent — pulling performance across Google Ads and Meta, reallocating budget between them, and acting whenever it detects a relevant task.
