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
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
Cursor opens with DuckDive filled in. Install it, then select Connect and continue with Google.
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/mcpRun the command, then type /mcp in Claude Code and continue with Google.
Gemini CLI
gemini mcp add --transport http duckdive https://api.duckdive.ai/mcpRun 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 / Fetch | Find the websites you can access in DuckDive and their connected data sources. |
|---|---|
| Get website | A website's name, URL and connected sources. |
| Setup status | What's set up so far (websites, Google connection, data sources) and what to do next. |
| Available sources | The Google Analytics 4 properties, Search Console sites and ads accounts your Google connection can reach. |
| Data sync status | Whether each source's data is ready, importing or failing, and how recent it is. |
| GA4 overview, channels, landing pages | Google Analytics 4 sessions, conversions and conversion rate, by day, channel or page. |
| Search Console summary, keywords, pages | Clicks, impressions, CTR and position, plus top queries and pages. |
| Google Ads summary | Spend, clicks, impressions, conversions and cost per conversion. |
| Local Services Ads summary | Leads, charged leads and spend. |
| Yext summary and reviews | Listing status, searches, views, actions, review counts and ratings. |
| Local rankings | Local Falcon map rankings: average rank and top-3 share per keyword. |
Actions (admin accounts only)
| Add website | Adds a website to your DuckDive account. Admins only. |
|---|---|
| Connect website sources | Links 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 data | Queues a re-import of recent data. Admins only, at most once per website every 15 minutes. |
| Create scheduled report | Schedules a recurring DuckDive email report, always sent to your own account email. Admins only. |
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.