diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 7eb2de2f..d6733f5e 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -93,6 +93,11 @@ "source": "third_party/google-calendar", "description": "Search events and schedule meetings." }, + { + "name": "google-analytics", + "source": "third_party/google-analytics", + "description": "Run reports, realtime queries, and metadata lookups on GA4 properties." + }, { "name": "gong", "source": "third_party/gong", diff --git a/README.md b/README.md index 5408d433..07ababd8 100644 --- a/README.md +++ b/README.md @@ -23,6 +23,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc | `gmail` | [Gmail](third_party/gmail/) | Cursor | Productivity | Search, read, draft, and manage email. | | `google-drive` | [Google Drive](third_party/google-drive/) | Cursor | Productivity | Search, read, create, and share files. | | `google-calendar` | [Google Calendar](third_party/google-calendar/) | Cursor | Productivity | Search events and schedule meetings. | +| `google-analytics` | [Google Analytics](third_party/google-analytics/) | Cursor | Integrations | Run reports, realtime queries, and metadata lookups on GA4 properties. | | `gong` | [Gong](third_party/gong/) | Cursor | Integrations | Pull account summaries, deal insights, and call briefs. | | `salesforce` | [Salesforce](third_party/salesforce/) | Cursor | Integrations | Query, create, and update records in your org. | | `playwright` | [Playwright](third_party/playwright/) | Cursor | Integrations | Navigate, click, screenshot, and test in a real browser. | diff --git a/third_party/google-analytics/.cursor-plugin/plugin.json b/third_party/google-analytics/.cursor-plugin/plugin.json new file mode 100644 index 00000000..63e736e0 --- /dev/null +++ b/third_party/google-analytics/.cursor-plugin/plugin.json @@ -0,0 +1,34 @@ +{ + "name": "google-analytics", + "displayName": "Google Analytics", + "version": "1.0.0", + "minClientVersions": { + "cursor": "3.13.0" + }, + "description": "Run reports, realtime queries, and metadata lookups on GA4 properties.", + "author": { + "name": "Cursor", + "email": "plugins@cursor.com" + }, + "homepage": "https://github.com/cursor/plugins/tree/main/third_party/google-analytics", + "repository": "https://github.com/cursor/plugins", + "license": "MIT", + "logo": "assets/logo.svg", + "keywords": [ + "google-analytics", + "google", + "analytics", + "mcp", + "ga4", + "reporting" + ], + "category": "integrations", + "tags": [ + "analytics", + "ga4", + "reporting", + "mcp", + "google" + ], + "mcpServers": "./mcp.json" +} diff --git a/third_party/google-analytics/CHANGELOG.md b/third_party/google-analytics/CHANGELOG.md new file mode 100644 index 00000000..b17000fd --- /dev/null +++ b/third_party/google-analytics/CHANGELOG.md @@ -0,0 +1,8 @@ +# Changelog + +All notable changes to this plugin will be documented here. + +## 1.0.0 — initial release + +- Logo: official Google Analytics product mark, on a padded white tile. +- Added the `google-analytics` MCP server pointing at `https://analyticsdata.googleapis.com/mcp/v1`. diff --git a/third_party/google-analytics/LICENSE b/third_party/google-analytics/LICENSE new file mode 100644 index 00000000..ca2bba77 --- /dev/null +++ b/third_party/google-analytics/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Cursor + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/third_party/google-analytics/README.md b/third_party/google-analytics/README.md new file mode 100644 index 00000000..001a34ff --- /dev/null +++ b/third_party/google-analytics/README.md @@ -0,0 +1,46 @@ +# Google Analytics + +Cursor plugin that connects agents to [Google Analytics](https://analytics.google.com) through Google's remote [Model Context Protocol](https://modelcontextprotocol.io/) server for the Google Analytics Data API. + +Run standard and realtime reports against GA4 properties, look up available dimensions and metrics (including custom definitions), and check dimension/metric compatibility before running a query. + +## Install + +1. Open **Cursor Settings → Plugins**. +2. Search for **Google Analytics**. +3. Click **Install**, then complete the Google sign-in prompt. + +Or run `/add-plugin google-analytics` in chat. + +## MCP + +```json +{ + "mcpServers": { + "google-analytics": { + "type": "http", + "url": "https://analyticsdata.googleapis.com/mcp/v1" + } + } +} +``` + +The `/mcp/v1` toolset exposes `run_report`, `run_realtime_report`, `get_metadata`, and `check_compatibility`. Access is read-only. + +Auth is OAuth 2.0 against Google. Cursor prompts for Google sign-in when the plugin connects. + +### OAuth scopes + +Google's Workspace MCP servers (Gmail, Google Drive, Google Calendar) and the Analytics Data MCP server all authenticate with Google OAuth, so this plugin may reuse Cursor's existing Google Workspace OAuth clients. The Analytics server needs scopes those clients do not request today, notably `https://www.googleapis.com/auth/analytics.readonly`, and adding them requires updating the OAuth consent screen and re-running Google's consent-screen verification for the new scopes. This plugin is packaging only; wiring the additional scopes into Cursor's auth backend is tracked separately and is not part of this plugin. + +## Docs + +- Google Analytics Data API MCP reference: https://developers.google.com/analytics/devguides/reporting/data/v1/mcp +- Google Analytics Data API: https://developers.google.com/analytics/devguides/reporting/data/v1 +- Google Cloud MCP servers overview: https://docs.cloud.google.com/mcp/overview + +Logo is the official Google Analytics product mark, placed on a white tile with padding so it reads well in the Cursor UI. + +## License + +MIT diff --git a/third_party/google-analytics/assets/logo.svg b/third_party/google-analytics/assets/logo.svg new file mode 100644 index 00000000..3ffa1767 --- /dev/null +++ b/third_party/google-analytics/assets/logo.svg @@ -0,0 +1 @@ + diff --git a/third_party/google-analytics/mcp.json b/third_party/google-analytics/mcp.json new file mode 100644 index 00000000..e15195d5 --- /dev/null +++ b/third_party/google-analytics/mcp.json @@ -0,0 +1,8 @@ +{ + "mcpServers": { + "google-analytics": { + "type": "http", + "url": "https://analyticsdata.googleapis.com/mcp/v1" + } + } +}