Merge branch 'main' of github.com:cagnusmarlsen/google-analytics-mcp

Author: cagnusmarlsen

CONTRIBUTING.md

@@ -65,7 +65,7 @@ Replace `PATH_TO_REPO` in the following snippet with the path where you cloned
 the repo:
 
 ```
-      "command": "PATH_TO_REPO/.venv/bin/google-analytics-mcp",
+      "command": "PATH_TO_REPO/.venv/bin/analytics-mcp",
 ```
 
 When running the `gemini` command from a terminal, add the `--debug` option so
@@ -90,8 +90,12 @@ branch named `awesome-feature-42` in this repo:
         "--no-cache",
         "--spec",
         "git+https://github.com/googleanalytics/google-analytics-mcp.git@awesome-feature-42",
-        "google-analytics-mcp"
-      ]
+        "analytics-mcp"
+      ],
+      "env": {
+        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
+        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID"
+      }
     }
   }
 }

README.md

@@ -1,14 +1,22 @@
 # Google Analytics MCP Server (Experimental)
 
+[![PyPI version](https://img.shields.io/pypi/v/analytics-mcp.svg)](https://pypi.org/project/analytics-mcp/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![GitHub branch check runs](https://img.shields.io/github/check-runs/googleanalytics/google-analytics-mcp/main)](https://github.com/googleanalytics/google-analytics-mcp/actions?query=branch%3Amain++)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/analytics-mcp)](https://pypi.org/project/analytics-mcp/)
+[![GitHub stars](https://img.shields.io/github/stars/googleanalytics/google-analytics-mcp?style=social)](https://github.com/googleanalytics/google-analytics-mcp/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/googleanalytics/google-analytics-mcp?style=social)](https://github.com/googleanalytics/google-analytics-mcp/network/members)
+[![YouTube Video Views](https://img.shields.io/youtube/views/PT4wGPxWiRQ)](https://www.youtube.com/watch?v=PT4wGPxWiRQ)
+
 This repo contains the source code for running a local
 [MCP](https://modelcontextprotocol.io) server that interacts with APIs for
 [Google Analytics](https://support.google.com/analytics).
 
 Join the discussion and ask questions in the
-[:robot:-analytics-mcp channel](https://discord.com/channels/971845904002871346/1398002598665257060)
+[🤖-analytics-mcp channel](https://discord.com/channels/971845904002871346/1398002598665257060)
 on Discord.
 
-## Tools :hammer_and_wrench:
+## Tools 🛠️
 
 The server uses the
 [Google Analytics Admin API](https://developers.google.com/analytics/devguides/config/admin/v1)
@@ -17,46 +25,46 @@ and
 to provide several
 [Tools](https://modelcontextprotocol.io/docs/concepts/tools) for use with LLMs.
 
-### Retrieve account and property information :orange_circle:
+### Retrieve account and property information 🟠
 
 - `get_account_summaries`: Retrieves information about the user's Google
   Analytics accounts and properties.
 - `get_property_details`: Returns details about a property.
 - `list_google_ads_links`: Returns a list of links to Google Ads accounts for
   a property.
 
-### Run core reports :orange_book:
+### Run core reports 📙
 
 - `run_report`: Runs a Google Analytics report using the Data API.
 - `get_custom_dimensions_and_metrics`: Retrieves the custom dimensions and
   metrics for a specific property.
 
-### Run realtime reports :hourglass_flowing_sand:
+### Run realtime reports ⏳
 
 - `run_realtime_report`: Runs a Google Analytics realtime report using the
   Data API.
 
-## Setup instructions
+## Setup instructions 🔧
 
 Setup involves the following steps:
 
 1.  Configure Python.
 1.  Configure credentials for Google Analytics.
 1.  Configure Gemini.
 
-### Configure Python :snake:
+### Configure Python 🐍
 
 [Install pipx](https://pipx.pypa.io/stable/#install-pipx).
 
-### Enable APIs in your project :white_check_mark:
+### Enable APIs in your project ✅
 
 [Follow the instructions](https://support.google.com/googleapi/answer/6158841)
 to enable the following APIs in your Google Cloud project:
 
 * [Google Analytics Admin API](https://console.cloud.google.com/apis/library/analyticsadmin.googleapis.com)
 * [Google Analytics Data API](https://console.cloud.google.com/apis/library/analyticsdata.googleapis.com)
 
-### Configure credentials :key:
+### Configure credentials 🔑
 
 Configure your [Application Default Credentials
 (ADC)](https://cloud.google.com/docs/authentication/provide-credentials-adc).
@@ -92,41 +100,26 @@ Here are some sample `gcloud` commands you might find useful:
     --scopes=https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform
   ```
 
+When the `gcloud auth application-default` command completes, copy the
+`PATH_TO_CREDENTIALS_JSON` file location printed to the console in the
+following message. You'll need this for the next step!
+
+```
+Credentials saved to file: [PATH_TO_CREDENTIALS_JSON]
+```
+
 ### Configure Gemini
 
 1.  Install [Gemini
     CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/index.md)
     or [Gemini Code
-    Assist](https://marketplace.visualstudio.com/items?itemName=Google.geminicodeassist)
+    Assist](https://marketplace.visualstudio.com/items?itemName=Google.geminicodeassist).
 
 1.  Create or edit the file at `~/.gemini/settings.json`, adding your server
     to the `mcpServers` list.
 
-    ```json
-    {
-      "mcpServers": {
-        "analytics-mcp": {
-          "command": "pipx",
-          "args": [
-            "run",
-            "--spec",
-            "git+https://github.com/googleanalytics/google-analytics-mcp.git",
-            "google-analytics-mcp"
-          ]
-        }
-      }
-    }
-    ```
-
-1.  **Optional:** Configure the `GOOGLE_APPLICATION_CREDENTIALS` environment
-    variable in Gemini settings. You may want to do this if you always want to
-    use a specific set of credentials, regardless of which Application Default
-    Credentials are selected in your current environment.
-
-    In `~/.gemini/settings.json`, add a `GOOGLE_APPLICATION_CREDENTIALS`
-    attribute to the `env` object. Replace `PATH_TO_ADC_JSON` in the following
-    example with the full path to the ADC JSON file you always want to use for
-    your MCP server.
+    Replace `PATH_TO_CREDENTIALS_JSON` with the path you copied in the previous
+    step.
 
     We also recommend that you add a `GOOGLE_CLOUD_PROJECT` attribute to the
     `env` object. Replace `YOUR_PROJECT_ID` in the following example with the
@@ -140,20 +133,18 @@ Here are some sample `gcloud` commands you might find useful:
           "command": "pipx",
           "args": [
             "run",
-            "--spec",
-            "git+https://github.com/googleanalytics/google-analytics-mcp.git",
-            "google-analytics-mcp"
+            "analytics-mcp"
           ],
           "env": {
-            "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_ADC_JSON",
-            "GOOGLE_CLOUD_PROJECT": "YOUR_PROJECT_ID"
+            "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
+            "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID"
           }
         }
       }
     }
     ```
 
-## Try it out :lab_coat:
+## Try it out 🥼
 
 Launch Gemini Code Assist or Gemini CLI and type `/mcp`. You should see
 `analytics-mcp` listed in the results.
@@ -190,6 +181,6 @@ Here are some sample prompts to get you started:
   what are the custom dimensions and custom metrics in my property?
   ```
 
-## Contributing
+## Contributing ✨
 
 Contributions welcome! See the [Contributing Guide](CONTRIBUTING.md).

analytics_mcp/tools/utils.py

@@ -31,7 +31,7 @@ def _get_package_version_with_fallback():
     Falls back to 'unknown' if the version can't be resolved.
     """
     try:
-        return metadata.version("google-analytics-mcp")
+        return metadata.version("analytics-mcp")
     except:
         return "unknown"
 

pyproject.toml

@@ -1,19 +1,52 @@
 [project]
-name = "google-analytics-mcp"
-version = "0.1.0"
+name = "analytics-mcp"
+description = "MCP server for Google Analytics"
+version = "0.1.1"
 # Lower bound of 3.10 due to the 'mcp' dependency:
 # https://github.com/modelcontextprotocol/python-sdk/blob/main/pyproject.toml
-requires-python = ">=3.10, <3.14"
+requires-python = ">=3.10"
 license = "Apache-2.0"
+readme = "README.md"
 dependencies = [
     "google-analytics-data==0.18.19",
     "google-analytics-admin==0.24.1",
     "google-auth~=2.40",
     "mcp[cli]>=1.2.0",
     "httpx>=0.28.1"
 ]
+keywords = [
+    "google analytics",
+    "analytics",
+    "mcp",
+    "ga4"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+    "Topic :: Internet",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Scientific/Engineering :: Information Analysis"
+]
+authors = [
+    { name = "Josh Radcliff", email = "jradcliff@users.noreply.github.com" },
+    { name = "Matt Landers", email = "matt-landers@users.noreply.github.com" }
+]
+
+[project.urls]
+homepage = "https://github.com/googleanalytics/google-analytics-mcp"
+repository = "https://github.com/googleanalytics/google-analytics-mcp.git"
+issues = "https://github.com/googleanalytics/google-analytics-mcp/issues"
 
 [project.scripts]
+analytics-mcp = "analytics_mcp.server:run_server"
+# The previous name of the script. Kept for backwards compatibility.
 google-analytics-mcp = "analytics_mcp.server:run_server"
 
 [project.optional-dependencies]
@@ -22,3 +55,6 @@ dev = [
     "nox >=2025.5.1, <2026"
 ]
 
+[build-system]
+requires = ["setuptools>=69.0.0", "wheel"]
+build-backend = "setuptools.build_meta"