feat: add support for funnel reports by cagnusmarlsen · Pull Request #54 · googleanalytics/google-analytics-mcp

cagnusmarlsen · 2025-09-02T07:25:09Z

This PR aims to add support for generating funnel reports using the Google Analytics MCP server. It adds a run_funnel_report tool that uses the runFunnelReport method to generate funnel reports based on user queries.

google-cla · 2025-09-02T07:25:15Z

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

jradcliff

Thank you so much for this PR! I added a few comments and suggestions.

Josh, Google Analytics team

jradcliff · 2025-09-03T15:47:46Z

analytics_mcp/tools/reporting/core.py

+    """Run a Google Analytics Data API funnel report.
+


Suggested change

"""Run a Google Analytics Data API funnel report.

"""Run a Google Analytics Data API funnel report.

See the funnel report guide at

https://developers.google.com/analytics/devguides/reporting/data/v1/funnels

for details and examples.

Yh data analysis programing method

jradcliff · 2025-09-03T15:51:42Z

analytics_mcp/tools/reporting/core.py

          """


+def _run_funnel_report_description() -> str:


Could you move this file into a funnel.py file, similar to how we separate out runReport into core.py, run_realtime_report into realtime.py, and get_custom_dimensions_and_metrics, etc. into metadata.py?

jradcliff · 2025-09-03T15:55:04Z

analytics_mcp/tools/reporting/core.py

+          Example:
+          [
+              {
+                  "name": "Page View",
+                  "filter_expression": {
+                      "funnel_field_filter": {
+                          "field_name": "eventName",
+                          "string_filter": {
+                              "match_type": "EXACT",
+                              "value": "page_view"
+                          }
+                      }
+                  }
+              },
+              {
+                  "name": "Sign Up",
+                  "event": "sign_up"
+              }
+          ]


Please move the JSON examples into separate methods that you call here, similar to what we're doing with date range hints, etc. for runReport:

google-analytics-mcp/analytics_mcp/tools/reporting/core.py

Line 67 in 7a569b5

### Hints for `date_ranges`:

This offers a few advantages:

It keeps this docstring reasonably short.

In the methods that return JSON, you can use the client library to generate the JSON so you know that it's well-formed. This will also make maintenance easier if the API objects evolve and change.

cagnusmarlsen · 2025-10-05T07:09:09Z

Hi Josh,
Thanks for reviewing! I apologize for the long delay, but I've made the requested changes. Thanks again.

matt-landers · 2026-02-10T14:14:25Z

@cagnusmarlsen If you can resolve the conflicts, I'll get this merged.

testyuminliang · 2026-03-18T08:27:13Z

analytics_mcp/tools/reporting/metadata.py

+                    ),
+                    data_v1alpha.FunnelFilterExpression(
+                        funnel_field_filter=data_v1alpha.FunnelFieldFilter(
+                            field_name="pagePath",


Hi! I use the funnel report function you created! But meet this problem:

{"error": "Failed to execute tool 'run_funnel_report': 400 Field 'pagePath' is not currently supported inside segments & funnel steps. For a list of valid dimensions and metrics, see https://developers.google.com/analytics/devguides/reporting/data/v1/exploration-api-schema "}"

I think you can use

`field_name="pageLocation", string_filter=data_v1alpha.StringFilter( match_type=data_v1alpha.StringFilter.MatchType.CONTAINS, value=step_dict["page_path"],`

It will also change the logic from EXACT to CONTAINS....but can get the data

mderazon · 2026-03-27T10:43:57Z

Would be great to merge this PR, seems like almost done ?
@cagnusmarlsen if you can't make it I can try

cagnusmarlsen · 2026-03-27T10:47:47Z

Hey, I've been meaning to get to this for a while. I'll resolve the conflicts over the weekend and we can hopefully get this merged after that!

…

On Fri, 27 Mar 2026 at 4:14 PM, Michael DeRazon ***@***.***> wrote: *mderazon* left a comment (googleanalytics/google-analytics-mcp#54) <#54?email_source=notifications&email_token=AV4QW5EAFCTO3NLBMJWTFM34SZLQHA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIMJUGE3TEMRVGQ3KM4TFMFZW63VHNVSW45DJN5XKKZLWMVXHJNLQOJPWG33NNVSW45C7N5YGK3S7MNWGSY3L#issuecomment-4141722546> Would be great to merge this PR, seems like almost done ? @cagnusmarlsen <https://github.com/cagnusmarlsen> if you can't make it I can try — Reply to this email directly, view it on GitHub <#54?email_source=notifications&email_token=AV4QW5EAFCTO3NLBMJWTFM34SZLQHA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIMJUGE3TEMRVGQ3KM4TFMFZW63VHNVSW45DJN5XKKZLWMVXHJNLQOJPWG33NNVSW45C7N5YGK3S7MNWGSY3L#issuecomment-4141722546>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AV4QW5BZXBAZQZDHRHM7FFT4SZLQHAVCNFSM6AAAAACFMJOV4SVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHM2DCNBRG4ZDENJUGY> . You are receiving this because you were mentioned.Message ID: ***@***.***>

mderazon · 2026-03-27T11:28:02Z

Thanks @cagnusmarlsen I created a new PR #127 based on your work to resolve the conflicts let's wait for @matt-landers / team to check it out

lawrencecode764-cloud · 2026-04-01T13:59:32Z

Thanks you every for sorporting the google service
Am happy and I really appreciate you all.
Am yuskay Lawrence management
Babason by name

cagnusmarlsen force-pushed the funnel_tool branch from 8becde3 to b46f025 Compare September 2, 2025 07:51

cagnusmarlsen added 5 commits September 2, 2025 13:30

feat: added funnel report generation

75e9d79

chore: improved prompt

d785907

chore: Linting

86fb756

docs: update README to add run_funnel_report tool

00070d7

chore: cleanup

0db3192

cagnusmarlsen force-pushed the funnel_tool branch from b46f025 to 0db3192 Compare September 2, 2025 08:06

jradcliff requested changes Sep 3, 2025

View reviewed changes

chore: create funnels.py, move funnel hints into separate method

d9080f6

fix: event_parameter_name instead of parameter_name

5c6df72

testyuminliang reviewed Mar 18, 2026

View reviewed changes

mderazon mentioned this pull request Mar 27, 2026

feat: add run_funnel_report tool using Data API v1alpha #127

Open

-    """Run a Google Analytics Data API funnel report.
+    """Run a Google Analytics Data API funnel report.
+    See the funnel report guide at
+    https://developers.google.com/analytics/devguides/reporting/data/v1/funnels
+    for details and examples.

Conversation

cagnusmarlsen commented Sep 2, 2025

Uh oh!

google-cla bot commented Sep 2, 2025

Uh oh!

jradcliff left a comment

Choose a reason for hiding this comment

Uh oh!

jradcliff Sep 3, 2025

Choose a reason for hiding this comment

Uh oh!

lawrencecode764-cloud Apr 1, 2026

Choose a reason for hiding this comment

Uh oh!

jradcliff Sep 3, 2025

Choose a reason for hiding this comment

Uh oh!

jradcliff Sep 3, 2025

Choose a reason for hiding this comment

Uh oh!

cagnusmarlsen commented Oct 5, 2025

Uh oh!

matt-landers commented Feb 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

testyuminliang Mar 18, 2026

Choose a reason for hiding this comment

Uh oh!

mderazon commented Mar 27, 2026

Uh oh!

cagnusmarlsen commented Mar 27, 2026 via email

Uh oh!

mderazon commented Mar 27, 2026

Uh oh!

lawrencecode764-cloud commented Apr 1, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

matt-landers commented Feb 10, 2026 •

edited

Loading