Docs

DuckDive for Claude, ChatGPT and other AI apps

Ask about your marketing data in plain language.

The DuckDive connector lets your AI assistant read the analytics you already have in DuckDive (Google Analytics 4, Search Console, Google Ads, Local Services Ads, Yext and Local Falcon) for the websites your DuckDive account can access. You sign in with your DuckDive account and choose what the assistant may do. It never sees your Google or other service passwords.

Let your AI set it up

Paste this into your AI assistant. It reads the setup guide and walks you through connecting DuckDive, adding your website and choosing your data.

Setup prompt

Set up DuckDive for my website. Follow https://analytics.duckdive.ai/agents.md

New to DuckDive? You don't need to sign up first. When you connect, a DuckDive page opens: select Continue with Google and your account is created for you.

Connect DuckDive

The MCP server URL for every app below is https://api.duckdive.ai/mcp.

Claude

Add to Claude

Claude opens with DuckDive filled in. Click Add, then Connect next to DuckDive, and continue with Google. Claude may show Reconnect or a connection problem instead of Connect. That's normal, click it.

Works on any Claude plan. Also works in the Claude desktop and mobile apps once added.

ChatGPT

Copy the URL https://api.duckdive.ai/mcp, then open ChatGPT.

In ChatGPT Plugins, click +, then “Add custom MCP server”. Name it DuckDive, paste the URL, choose OAuth, tick “I understand and want to continue”, click “Create as a plugin”, then install it and continue with Google.

Needs ChatGPT Business or Enterprise. It won't work on Free or Plus.

Gemini

Copy the URL https://api.duckdive.ai/mcp, then open Gemini.

Under “Custom apps”, paste the URL into “Add a custom app link to get started”, click Next and continue with Google.

Only in the US, with a personal Google account.

Grok

Copy the URL https://api.duckdive.ai/mcp, then open Grok.

Click New Connector, then Custom. Name it DuckDive, paste the URL, click Add, then Connect and continue with Google.

Muse (Meta)

Muse, Meta's assistant, can add a remote MCP server as a custom connector. Add a custom connector, name it DuckDive, use the MCP URL https://api.duckdive.ai/mcp and choose OAuth, then continue with Google when the DuckDive page opens.

DuckDive has not yet officially tested the connector with Muse, and there is no official guide for it. Menu names may differ; look for "Connectors", "Apps" or "MCP".

Cursor

Add to Cursor

Cursor opens with DuckDive filled in. Install it, then select Connect and continue with Google.

VS Code

Add to VS Code

VS Code opens with DuckDive filled in. Install it, then continue with Google when asked.

Claude Code

claude mcp add --transport http duckdive https://api.duckdive.ai/mcp

Run the command, then type /mcp in Claude Code and continue with Google.

Gemini CLI

gemini mcp add --transport http duckdive https://api.duckdive.ai/mcp

Run the command, then type /mcp auth duckdive in Gemini CLI and continue with Google.

Any app with remote MCP

From your AI app's connector directory

  • Open your AI app's connectors (in Claude: Customize → Connectors) and find DuckDive.
  • Select Connect. On the DuckDive page that opens, select Continue with Google. New users get an account automatically.
  • Already signed in to DuckDive? Review the request and select Allow.

As a custom connector (any app that supports remote MCP servers)

  • Add a custom connector, sometimes called a remote MCP server, in your AI app.
  • Use this URL: https://api.duckdive.ai/mcp
  • When the DuckDive page opens, select Continue with Google.

Menu names differ between apps and change over time; look for "Connectors", "Apps" or "MCP".

What you can ask

  • "How did organic traffic to my site change over the last 30 days?"
  • "Which landing pages had the most conversions this month?"
  • "What are my top Google search queries, and which ones lost clicks?"
  • "How much did we spend on Google Ads last week, and what was the cost per conversion?"
  • "Compare Local Services Ads leads across all my locations."

Tools

Read-only (always available once connected)

List websites / Search / FetchFind the websites you can access in DuckDive and their connected data sources.
Get websiteA website's name, URL and connected sources.
Setup statusWhat's set up so far (websites, Google connection, data sources) and what to do next.
Available sourcesThe Google Analytics 4 properties, Search Console sites and ads accounts your Google connection can reach.
Data sync statusWhether each source's data is ready, importing or failing, and how recent it is.
GA4 overview, channels, landing pagesGoogle Analytics 4 sessions, conversions and conversion rate, by day, channel or page.
Search Console summary, keywords, pagesClicks, impressions, CTR and position, plus top queries and pages.
Google Ads summarySpend, clicks, impressions, conversions and cost per conversion.
Local Services Ads summaryLeads, charged leads and spend.
Yext summary and reviewsListing status, searches, views, actions, review counts and ratings.
Local rankingsLocal Falcon map rankings: average rank and top-3 share per keyword.

Actions (admin accounts only)

Add websiteAdds a website to your DuckDive account. Admins only.
Connect website sourcesLinks a website to its Google Analytics 4 property, Search Console site and ads accounts, then starts the import. Admins only; never moves a source from another website without your OK.
Refresh website dataQueues a re-import of recent data. Admins only, at most once per website every 15 minutes.
Create scheduled reportSchedules a recurring DuckDive email report, always sent to your own account email. Admins only.

Full tool reference

The connector can't delete data, connect or disconnect your Google account, or send email to anyone other than you.

Permissions and access

  • The assistant sees only the websites your DuckDive account can already see, with your role's permissions.
  • Connecting gives the app read access. For account admins it also includes the actions above; everyone else gets read-only access.
  • Sign-in uses OAuth 2.0. The AI app receives a DuckDive access token, never your password.
  • Disconnect at any time in DuckDive under AI Connectors, or remove the connector in your AI app. Access stops immediately.

Data and privacy

When you ask a question, the AI app calls DuckDive's tools and receives the analytics data needed to answer it. DuckDive logs which tool was used, for which website, when, whether it succeeded, and a copy of the request with sensitive values removed, to keep the service secure and to support you. DuckDive does not receive your conversation with the assistant.

How the AI provider stores conversations and tool results is governed by that provider's own policies. See the DuckDive Privacy Policy for details.

Troubleshooting

  • No websites found: ask your assistant to help you set up DuckDive, or add a website on the setup page after signing in.
  • Data looks empty or old: ask for the data sync status; a newly connected source can take a while to import.
  • "Not allowed" for an action: actions need an admin account. If you unticked them when connecting, disconnect the app in AI Connectors and connect again.
  • Sign-in loops or fails: sign in to DuckDive in the same browser first, then connect again.

Support

Questions or problems: email hello@duckdive.ai. Guide for AI agents: https://analytics.duckdive.ai/agents.md.