CLI or MCP — which connection 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 if you want a persistent config in ~/.hermes/config.yaml with your Composio API key, which is handy for servers and reproducible deployments. Both end up connecting through the same official platform APIs.

Ira Bodnar·July 1, 2026·9 min read

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:

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:

hermes chat

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.

Google Ads account connected via OAuth — the authorized account email shows in the connection modal — After you authorize, the account shows up connected under the email you signed in with — the password stays with Google.

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.

An MCP connector card with a copyable MCP server URL — An MCP connection is just a URL (shown here: Ryze’s connector card). Copy it once, paste it into the agent’s config, and every tool behind it becomes available.

Open the Hermes config

terminal

nano ~/.hermes/config.yaml

Add the Composio MCP server block

Paste this under your config, dropping in your own API key:

~/.hermes/config.yaml

mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

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

Free SEO/GEO audit

Surface technical SEO issues
Spot quick wins
Find duplicate and thin pages

Free · no credit card · instant

After you connect

What Hermes can do once Google & Meta are connected

Ad platform integrations connected through official APIs: Google Ads, Meta Ads, TikTok Ads and Reddit Ads — Each platform connects once through its official API — after that, the agent can read performance and act across all of them.

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

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.

Show 2 more questions

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.

AI ad manager, fully managed

official APIs · no server · free trial