SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Google AdSense MCP with Hermes

Connect Hermes to Google AdSense MCP. List google adsense sites needing review, show adsense earnings for last month, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Google AdSense logoGoogle AdSense
Oauth2

Google AdSense is a platform for managing website advertising, payments, and performance reports. It helps publishers monetize content and track ad revenue in one place.

33 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Google AdSense account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Google AdSense with

ChatGPTClaude CoworkAtomic Agent

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Google AdSense with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Google AdSense

Ask your agent to connect to Google AdSense, or simply request any Google AdSense-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Google AdSense connection.

Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

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

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Google AdSense or request any Google AdSense-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Google AdSense MCP server, and what's possible with it?

The Google AdSense MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Google AdSense account. It provides structured and secure access to ad inventory, channels, sites, policy issues, payments, and performance reports, so your agent can manage ad units, review site and policy status, track payments, and analyze AdSense performance on your behalf.

  • Ad inventory management: Have your agent create, view, update, and retrieve code for display ad units in your AdSense account.
  • Channel organization: Let the agent create, inspect, update, and delete custom channels, or review URL channels and the ad units linked to them.
  • Performance reporting: Direct your agent to generate structured or CSV reports for selected AdSense performance data, or run saved reports.
  • Site and policy monitoring: Instruct your agent to list available sites, review policy issues and enforcement details, and retrieve account alerts.
  • Account and payment visibility: Have your agent review account details, list managed accounts, and retrieve paid and unpaid payment records.

Way Forward

With Google AdSense connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Google AdSense action and event your agent gets out of the box.

Create Ad Unit

Create a permanent DISPLAY ad unit under an AFC ad client.

Create Custom Channel

Create a custom channel under an ad client.

Delete Custom Channel

Permanently delete a Google AdSense custom channel.

Generate Report

Generate an ad hoc AdSense report as structured JSON rows.

Generate Report CSV

Generate an ad hoc AdSense report and return its CSV text verbatim.

Generate Saved Report

Run a publisher-created saved report and return structured JSON rows.

Generate Saved Report CSV

Run a publisher-created saved AdSense report and return CSV text.

Get Account

Return one AdSense account's state, setup tasks, timezone, and premium status.

Get Ad Blocking Recovery Tag

Return an account's ad blocking recovery tag and its optional error-protection code.

Get Ad Client

Return one ad client by its complete resource name.

Get Ad Client Code

Return standard and AMP AdSense code snippets for an AFC ad client.

Get Ad Unit

Return one Google AdSense ad unit by its complete resource name.

Get Ad Unit Code

Return the complete HTML code snippet for one Google AdSense ad unit.

Get Custom Channel

Return one custom channel by its complete resource name.

Get Policy Issue

Return one AdSense policy issue and all of its enforcement details.

Get Saved Report

Return one saved report's complete resource name and title.

Get Site

Return one AdSense site by its complete resource name.

Get URL Channel

Return one URL channel by its complete resource name.

List Accounts

Return one page of AdSense accounts available to the connected user.

List Ad Clients

Return one page of ad clients available in an AdSense account.

List Ad Unit Custom Channels

Return one page of custom channels linked to an AdSense ad unit.

List Ad Units

Return one page of ad units owned by an AdSense ad client.

List Alerts

Return AdSense account alerts localized to an optional language.

List Child Accounts

Return one page of accounts directly managed by a parent AdSense account.

List Custom Channel Ad Units

Return one page of ad units linked to a custom channel.

List Custom Channels

Return one page of custom channels owned by an AdSense ad client.

List Payments

Return paid and unpaid payment records available for an AdSense account.

List Policy Issues

Return one page of policy issues affecting an account or its AFP children.

List Saved Reports

Return one page of publisher-created saved reports for an account.

List Sites

Return one page of sites available in an AdSense account.

List URL Channels

Return one page of active URL channels owned by an AdSense ad client.

Update Ad Unit

Replace all writable settings of a DISPLAY ad unit.

Update Custom Channel

Replace all writable settings of a custom channel.

FRAMEWORKS

How to build Google AdSense MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Google AdSense MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use Google AdSense MCP with Claude Cowork

Atomic Agent logo

Atomic Agent

Use Google AdSense MCP with Atomic Agent

FAQ

Frequently asked questions

With a standalone Google AdSense MCP server, the agents and LLMs can only access a fixed set of Google AdSense tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Google AdSense and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Google AdSense tools.

Yes, absolutely. You can configure which Google AdSense scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Google AdSense data and credentials are handled as safely as possible.

Start with Google AdSense.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Google AdSense tool your agent needs.Free to start.

Start building