English Français العربية

QuerySail: Google Analytics

السجل الرسمي التسويق والمبيعات

Hosted, read-only Google Analytics 4 MCP: reports, period comparisons, realtime, custom fields.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http querysail-google-analytics 'https://mcp.querysail.com/ga4/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "querysail-google-analytics": {
            "type": "http",
            "url": "https://mcp.querysail.com/ga4/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. QuerySail: Google Analytics MCP server
  2. Tools
  3. Example prompts
  4. Setup
  5. Data and limits
  6. License

QuerySail: Google Analytics MCP server

QuerySail is a hosted, read-only MCP server for Google Analytics 4. Connect it to ChatGPT, Claude, Codex, Cursor or VS Code, sign in, connect your Google account once, and ask about your traffic, engagement and conversions in plain language. There is nothing to install, no Google Cloud project and no API key to paste.

This repository holds the public listing files (MCP Registry server.json, a Claude Code plugin, client configs). The service itself is hosted at querysail.com; its source is not published here.

Tools

All tools are read-only. QuerySail cannot create or edit properties, data streams, key events, audiences or any other Google Analytics setting.

ToolWhat it does
list_propertiesLists the Google Analytics 4 properties your connected Google accounts can read, with exact property IDs and their Analytics accounts.
list_fieldsLists the dimensions and metrics a property can report on, including its custom dimensions, custom metrics and key events.
run_reportUsers, sessions, views, engagement, events, key events, revenue and any other Data API metric, broken down by date, channel, source/medium, landing page, page, country, device, event and more, with filters.
compare_reportCompares two periods (previous period, same weekdays a year earlier, or custom dates) and lists the channels, sources, pages or countries that gained or lost the most.
run_realtime_reportActive users, views and events in the last 30 minutes, by country, city, device, page or event.

Example prompts

  • How many users and sessions did my site have in the last 28 days?
  • Which channels brought the most sessions last month, and how did that change from the month before?
  • What are my top landing pages by key events?
  • How many people are on the site right now, and from which countries?
  • Compare organic search sessions with the same weeks last year.

Setup

You need a QuerySail account with Google Analytics connected: sign up at https://querysail.com and choose Connect Google Analytics under Account → Connections. Each client below opens a browser window to sign in the first time.

Claude Code
claude mcp add --transport http --scope user querysail-ga4 https://mcp.querysail.com/ga4/mcp

Then run /mcp, choose querysail-ga4 and sign in. Or install it as a plugin, which also adds a Google Analytics analysis skill:

/plugin marketplace add querysail/querysail-ga4
/plugin install querysail-ga4@querysail-ga4
Claude Desktop and claude.ai

Open Customize → Connectors, select + Add → Add custom connector, name it QuerySail GA4 and paste https://mcp.querysail.com/ga4/mcp as the server URL.

ChatGPT

Turn on Developer mode under Settings → Security and login, go to chatgpt.com/plugins, select the plus button and paste the endpoint as the connection URL.

Codex
codex mcp add querysail-ga4 --url https://mcp.querysail.com/ga4/mcp
codex mcp login querysail-ga4
Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "querysail-ga4": { "url": "https://mcp.querysail.com/ga4/mcp" }
  }
}
VS Code

Run MCP: Add Server, choose HTTP and paste the endpoint, or add to mcp.json:

{
  "servers": {
    "querysail-ga4": { "type": "http", "url": "https://mcp.querysail.com/ga4/mcp" }
  }
}
Clients that only run local commands

Use the mcp-remote bridge (needs Node.js):

{
  "mcpServers": {
    "querysail-ga4": { "command": "npx", "args": ["mcp-remote", "https://mcp.querysail.com/ga4/mcp"] }
  }
}

Data and limits

  • Google access uses the analytics.readonly scope, granted separately from Search Console. Refresh tokens are encrypted at rest. You can hide properties, disconnect Google or delete your account at any time.
  • Reports are fetched from Google when asked and cached for at most 15 minutes; realtime reports are not cached. Universal Analytics properties are not supported.
  • Google may apply thresholding or sampling to some reports; QuerySail passes those flags on to your assistant. Google's per-property API quotas apply.
  • Privacy: https://querysail.com/privacy · Terms: https://querysail.com/terms · Support: https://querysail.com/support

License

The files in this repository are MIT licensed. The QuerySail service is subject to its terms.

الأسئلة الشائعة

ما هو QuerySail: Google Analytics؟

Hosted, read-only Google Analytics 4 MCP: reports, period comparisons, realtime, custom fields.

كيف أثبّت QuerySail: Google Analytics؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http querysail-google-analytics 'https://mcp.querysail.com/ga4/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج QuerySail: Google Analytics إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل QuerySail: Google Analytics مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون QuerySail: Google Analytics؟

ينشره querysail. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.