drafty
Google Ads logo

Build a Google Ads dashboard with Claude

Connect the official Google Ads MCP server to Claude, ask for a spend, ROAS, and CPC dashboard from your live campaign data, and publish it to a link your team comments on directly — no BI tool, no screenshots pasted into Slack.

What you'll build
A self-contained performance dashboard — total spend, ROAS, CPC, conversions, and a per-campaign breakdown — generated by Claude from your real Google Ads data, then published to a drafty.im/canvas/… link. Your team clicks the exact tile or campaign row they want changed and leaves a note. Claude reads the comments and ships a revised version to the same URL.

This is an end-to-end example: connect a data source over MCP, generate a dashboard from live numbers, and close the review loop on one link. Total time, start to shared link, is under fifteen minutes. The same shape works for any of the other examples — only the connection step changes.

Here's the finished dashboard, published to a canvas — click any tile or number to leave a comment, exactly as your team would:

Live canvas — comment on any elementOpen ↗

The three moving parts

  1. The Google Ads MCP server gives Claude read access to your Google Ads account — campaigns, ad groups, keywords, spend, and conversion metrics — through a controlled set of tools. The official server is read-only by design.
  2. Claude pulls the numbers and writes a single self-contained HTML dashboard. You iterate on it in the artifact panel until it's right.
  3. Drafty turns that HTML into a stable link your team reviews. Comments pin to the exact element; Claude ships the fix to the same URL.

The generation step is fast now. The part this example is really about is the third one — getting the dashboard in front of people without losing their feedback to a screenshot circled in Preview.

Step 1 — Connect the Google Ads MCP server

Google publishes an official Google Ads MCP server. It runs locally with pipx and reads your account through the Google Ads API. You'll need a developer token (Explorer access is enough), a Google Cloud project ID, and OAuth credentials — set up Application Default Credentials once and the server uses them.

Authorize the read scope once with the gcloud CLI:

claude
gcloud auth application-default login --scopes=https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform

In Claude Code, register the server (swap in your token and project ID):

claude
claude mcp add google-ads --env GOOGLE_PROJECT_ID=YOUR_PROJECT_ID --env GOOGLE_ADS_DEVELOPER_TOKEN=YOUR_DEVELOPER_TOKEN -- pipx run --spec git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp

In Claude Desktop: open Settings → Connectors → Add custom connector and add the same pipx run --spec git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp command, with GOOGLE_PROJECT_ID and GOOGLE_ADS_DEVELOPER_TOKEN set in the connector's environment.

Safety first
The official server is read-only — it can run reporting queries but cannot pause a campaign, move a budget, or create an asset. Authorize the single adwords scope and nothing more, keep your developer token in the environment (never committed to a repo), and let Application Default Credentials hold the OAuth refresh. The dashboard only reads.

Step 2 — Pull the numbers

Ask Claude in plain language. It uses the MCP server's read tools (list_accessible_customers, then search with a GAQL query) to fetch real data:

claude
Using the Google Ads MCP server, list my accessible accounts, then for the main account pull everything I need for a performance dashboard over the last 30 days: total cost (spend), conversions and conversion value, ROAS (conversion value / cost), average CPC, clicks, impressions, CTR, and the same metrics broken down per campaign. Summarize the figures before you build anything.

Claude calls Google Ads, returns the figures, and you sanity-check them against the Google Ads UI before going further. This is the moment to catch a wrong assumption — the wrong customer ID, a conversion action you didn't mean to count, a date range off by a day — while it's cheap.

Step 3 — Build the dashboard

Once the numbers look right, ask for the artifact:

claude
Build a single self-contained HTML dashboard from those figures. Total spend as the hero number with month-over-month change, then tiles for ROAS, average CPC, and conversions. A per-campaign table at the bottom with spend, ROAS, and CPC per row. Clean, no external dependencies — inline the CSS and any chart code.

Claude renders it live in the artifact panel. Iterate in place — you're not regenerating from scratch:

Step 4 — Publish to Drafty for review

A Claude artifact link is a preview, not a stable URL — iterate the artifact and the link you already sent now shows the old version. Ask Claude to publish it to a Drafty canvas instead, so the link you share always stays current:

claude
Publish this dashboard to Drafty as a canvas and give me the shareable link.

Claude pushes the dashboard and hands back a drafty.im/canvas/… link that renders on any device. Send it — your team opens it in a browser, no login and no Claude account needed.

Step 5 — The review loop

This is the part that's not obvious until you've done it once.

A reviewer clicks the specific tile, chart, or campaign row they want changed and leaves a pinned comment — "this ROAS looks high, are we counting view-through conversions?" The comment is anchored to that element, not floating in a Slack thread. Claude reads the comments through the CLI, reruns the relevant GAQL query if needed, and pushes a revised dashboard to the same URL. The reviewer refreshes and sees the change; the thread stays attached to the element.

The mechanic matters because of what it removes. A Slack message about a chart produces "the number on the left looks wrong." A pinned comment on the actual tile produces "this — exclude view-through conversions from ROAS." One of those produces a correct revision; the other produces a guess.

Keeping it fresh

An MCP-generated dashboard is a snapshot — it holds the numbers Claude pulled when it built it; it doesn't re-query Google Ads when someone opens the link. For a weekly review or a board-ready snapshot, that's fine.

To make it a live canvas that always shows today's figures, copy this prompt — Claude sets up the refresh for you and schedules it to run on its own:

claude
Turn this Google Ads dashboard into a live canvas: every morning, re-pull the latest spend, ROAS, CPC, and conversion numbers from Google Ads via the MCP server, rebuild the dashboard, and push a new version to the same canvas URL so the link always shows today's figures. Schedule it to run daily on its own.

The link stays stable while the content updates underneath it — see keeping a canvas updated automatically.

What to watch for

Google Ads dashboard with Claude — FAQ

Do I need to paste my developer token or OAuth secret anywhere risky?
Your Google Ads developer token and project ID go in the MCP server's environment, not into a committed file. OAuth is handled by Application Default Credentials — you run gcloud auth application-default login once with the adwords scope, and the server uses the stored refresh token. Never commit the developer token to a repo.
Is the dashboard live or a snapshot?
A snapshot. It contains the numbers Claude pulled when it built the file; it does not re-query Google Ads when someone opens the link. To refresh it, ask Claude to repull and re-push to the same URL — or put that on a daily schedule so the stable link always shows current numbers.
Can my team comment without a Google Ads or Claude account?
Yes. The dashboard is published to a Drafty canvas link that renders in any browser. Reviewers click the exact element they want changed and leave a pinned comment with no login required. Only the person connecting Google Ads needs access to the account.
Is it safe to give Claude access to my Google Ads account?
The official Google Ads MCP server is read-only — it can run reporting queries but cannot pause campaigns, change budgets, or create assets. Authorize only the adwords scope, keep the developer token in the environment, and a performance dashboard never needs more than that.
How is this different from Looker Studio or the Google Ads reports?
Looker Studio and the native Google Ads reports query live data against connectors and views you maintain — the right choice for governed, scheduled reporting at scale. This approach is for a fast, shareable snapshot you can spin up in minutes and iterate by talking to Claude, then collect feedback on inline. Different jobs: one is a standing system, the other is a quick reviewable deliverable.