Skip to main content
Glama
OQVA Marketing MCP

OQVA Marketing MCP

Official
by oqva-digital

OQVA Marketing MCP

Connect Claude to your marketing data. This MCP server lets Claude read and manage your Google and Meta accounts directly:

  • Google Search Console — search analytics, sitemaps, URL inspection

  • Google Analytics 4 — reports, realtime, and configuration

  • Meta (Facebook & Instagram) — Page insights and Ads

  • Google Tag Manager — tags, triggers, variables, publishing

  • Google Business Profile — locations, performance, reviews (needs Google approval)

  • Keyword research & demand radar — search volumes, live SERPs, autocomplete mining, change tracking (DataForSEO pay-per-call; the autocomplete tool is free)

Install

macOS / Linux — paste this into a terminal:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/oqva-digital/oqva-marketing-mcp/main/install.sh)"

Windows — download oqva-marketing-mcp-Windows-x86_64.exe from the latest release and run:

oqva-marketing-mcp-Windows-x86_64.exe setup

Installing runs a guided setup that connects your accounts, checks each one, and adds the tool to Claude. Restart Claude when it finishes.

Related MCP server: marketing-data-hub

Setup

setup walks you through each account and verifies it as you go:

  • Google — you create a free Google Cloud OAuth client; setup opens your browser to sign in and stores the access for you. One sign-in covers Search Console, Analytics, Tag Manager, and Business Profile.

  • Meta — you paste a Business Manager access token; setup finds your Page and ad account for you.

Step-by-step credential guide: SETUP.md. Everything you enter is stored only on your own computer, at ~/.oqva-marketing-mcp/.env.

Commands

oqva-marketing-mcp setup     guided setup — connect accounts, register with Claude (run anytime)
oqva-marketing-mcp doctor    check every connection
oqva-marketing-mcp auth      re-do the Google sign-in

Tools

Tool

What it does

config_status

Which sources are configured (no secrets shown). Call first if something says "not configured".

gsc_list_sites

Properties the OAuth account can read (confirms access + exact siteUrl).

gsc_query

Search Analytics — clicks/impressions/CTR/position by query/page/country/device/date. Live + filterable.

gsc_list_sitemaps

Submitted sitemaps + status.

gsc_inspect_url

Index/coverage/canonical for one URL.

ga4_run_report

GA4 Data API: sessions/users/conversions/events by any dimensions, any date range.

ga4_realtime

Active users in the last 30 min.

gbp_list_accounts / gbp_list_locations

Business Profile accounts + locations. (needs GBP API approval)

gbp_get_location

One location in full — description, hours, service area, service items. (needs approval)

gbp_search_categories

Look up a category id by display name (Cleaners → categories/gcid:cleaners).

gbp_search_places

Look up Google Place IDs for a serviceArea. (needs GOOGLE_MAPS_API_KEY)

gbp_update_location

[write] Edit categories, phone, website, description, hours, service area, services. Supports validateOnly dry runs. (needs approval)

gbp_performance

Daily impressions/calls/website-clicks/directions for a location. (needs approval)

gbp_list_reviews

Reviews (rating, text, reply). (needs approval)

gbp_reply_review

[write] Reply to a review. (needs approval)

gbp_list_available_attributes / gbp_get_attributes

Attributes the category allows vs. the ones actually set.

gbp_update_attributes

[write] Set/clear profile attributes (booking link, socials, "online estimates"…).

gbp_list_posts

Google Posts on the profile (v4 API). (No Q&A tools: Google shut the Q&A API down on 2025-11-03.)

gbp_create_post / gbp_delete_post

[write] Publish / remove a Google Post (summary + CTA button + photo).

meta_graph

[write-capable] Raw Meta Graph/Marketing API call — GET / POST / DELETE escape hatch.

meta_page_insights

Facebook Page insights.

meta_ad_insights

Ad-account insights (only if you run Meta ads).

meta_list_ad_accounts · meta_list_businesses · meta_list_pages

Enumerate Meta assets (ads audit).

meta_list_campaigns · meta_list_custom_audiences · meta_list_pixels

List campaigns / audiences / pixels on an ad account.

meta_update_campaign

[write] pause / archive / activate a campaign.

meta_delete_custom_audience

[write] delete a custom audience.

ga4_account_summaries

List your GA4 accounts/properties + their numeric ids.

ga4_list_key_events · ga4_create_key_event

[write] read / create Key events (conversions).

ga4_list_custom_dimensions · ga4_create_custom_dimension

[write] read / create custom dimensions.

ga4_list_data_streams

List data streams (+ measurement ids).

ga4_admin

[write] GA4 Admin API escape hatch (audiences, property/stream edits).

gsc_submit_sitemap · gsc_delete_sitemap · gsc_add_site

[write] manage sitemaps + properties.

gsc_request_indexing

[write] request a recrawl (Indexing API).

gtm

[write + publish] Google Tag Manager API escape hatch (tags/triggers/variables → version → publish).

kw_volume

Keyword search volumes + CPC + competition + 12-month trend, batched 500/call. (needs DATAFORSEO_LOGIN/_PASSWORD — pay-per-call, no subscription)

kw_serp

Live top-10 organic Google results for a keyword, plus whether ads share the SERP. (needs DataForSEO)

kw_suggest

Mine Google autocomplete around a seed topic — what people actually type. Free, no key.

kw_radar

Sweep a saved keyword cluster file (volume + SERP + suggest presence per market), snapshot it, and report only what changed — watchlist first-appearances, volume shifts, SERP movers. (needs DataForSEO)

Security

  • Credentials live only at ~/.oqva-marketing-mcp/.env on your machine, and go only to Google, Meta, and DataForSEO.

  • Write tools are tagged [WRITE]; Claude confirms before anything destructive or public (a review reply, a Tag Manager publish).

Build from source

One TypeScript file, no runtime dependencies. To run it from source instead of the binary:

npm install        # TypeScript toolchain only
npm run setup      # build, then guided setup
npm run doctor     # check connections
npm start          # run as the MCP server

Release binaries are built with Bun:

./build.sh         # compiles the macOS/Linux/Windows binaries into dist/

Create a GitHub release and upload the five files; install.sh downloads them by name.

License

Apache-2.0 © OQVA.

Available Tools

35 tools
config_statusA

Report which marketing data sources are configured (no secrets revealed). Call first if a tool says 'not configured'.

Inputs: no named parameters.

ga4_account_summariesA

GA4 Admin: list the accounts + properties you can access, including each property's NUMERIC id — use this to discover GA4_PROPERTY_ID.

Inputs: no named parameters.

ga4_adminA

GA4 Admin API escape hatch — any method/path under analyticsadmin v1beta (audiences, property/stream updates, etc.). WRITES are real; PATCH usually needs a updateMask query.

Inputs: method (required), path (required), body, query.

ga4_create_custom_dimensionA

GA4 Admin [WRITE]: register an event parameter as a custom dimension (e.g. surface a 'step' param as 'Booking Step').

Inputs: parameterName (required), displayName (required), scope, propertyId.

ga4_create_key_eventB

GA4 Admin [WRITE]: mark an event name as a Key event (conversion). e.g. eventName='generate_lead'.

Inputs: eventName (required), propertyId, countingMethod.

ga4_list_custom_dimensionsC

GA4 Admin: list custom dimensions on a property.

Inputs: propertyId.

ga4_list_data_streamsC

GA4 Admin: list data streams (web/app) on a property — incl. the measurement id.

Inputs: propertyId.

ga4_list_key_eventsB

GA4 Admin: list key events (conversions) on a property.

Inputs: propertyId.

ga4_realtimeC

GA4 realtime report (active users in the last 30 min).

Inputs: propertyId, metrics, dimensions.

ga4_run_reportB

GA4 Data API runReport — sessions, users, conversions, events, channels. Flexible dimensions + metrics over a date range.

Inputs: startDate (required), endDate (required), metrics (required), dimensions, +4 more.

gbp_list_accountsA

[GBP] List Business Profile accounts. NOTE: the Business Profile APIs require Google to approve API access (allowlist) first.

Inputs: no named parameters.

gbp_list_locationsA

[GBP] List locations for an account (name, title, address, website, categories).

Inputs: account.

gbp_list_reviewsA

[GBP] List reviews for a location (rating, comment, reviewer, time, any reply).

Inputs: location (required).

gbp_performanceB

[GBP] Daily performance time series for a location: impressions (maps/search × desktop/mobile), call clicks, website clicks, direction requests, conversations, bookings.

Inputs: location (required), metric (required), startDate (required), endDate (required).

gbp_reply_reviewC

[GBP][WRITE] Post (or update) the business reply to a review.

Inputs: location (required), reviewId (required), comment (required).

gsc_add_siteB

GSC [WRITE]: add a property to Search Console (ownership still has to be verified separately).

Inputs: siteUrl (required).

gsc_delete_sitemapA

GSC [WRITE]: remove a sitemap (re-submittable).

Inputs: feedpath (required), siteUrl.

gsc_inspect_urlB

URL Inspection — index/coverage status, last crawl, canonical, mobile usability for one URL.

Inputs: inspectionUrl (required), siteUrl.

gsc_list_sitemapsC

List submitted sitemaps + processing status for a property.

Inputs: siteUrl.

gsc_list_sitesA

List Search Console properties the service account can access (confirm the SA is granted + the exact siteUrl).

Inputs: no named parameters.

gsc_queryA

Search Console Search Analytics — clicks / impressions / CTR / position grouped by dimension(s). The core SEO tool (same data as the GSC Performance export, but live + filterable).

Inputs: startDate (required), endDate (required), dimensions, siteUrl, +5 more.

gsc_request_indexingA

Indexing API [WRITE]: ask Google to (re)crawl a URL. NOTE: officially for JobPosting/BroadcastEvent pages; pinging general URLs works but is unofficial.

Inputs: url (required), type.

gsc_submit_sitemapC

GSC [WRITE]: submit / resubmit a sitemap.

Inputs: feedpath (required), siteUrl.

gtmA

Google Tag Manager API v2 escape hatch — any method/path under tagmanager/v2. Discover: GET 'accounts', then '/containers', then '/workspaces'. Manage: GET/POST '/tags' | '/triggers' | '/variables'; create a version (POST ':create_version'); publish (POST ':publish'). WRITES + PUBLISH are real and affect the live site — build in a workspace, publish deliberately.

Inputs: method (required), path (required), body, query.

meta_ad_insightsB

[Meta] Ad account insights (impressions, clicks, spend, actions, CPC, CTR). Only returns data if you actually run Meta ads.

Inputs: adAccountId, fields, datePreset, level.

meta_delete_custom_audienceA

[Meta][WRITE] Delete a custom audience (destructive — removed, not archived).

Inputs: audienceId (required).

meta_graphA

Meta Graph / Marketing API call — flexible escape hatch, READ and WRITE. method defaults GET; POST to create/update (e.g. path='', params={status:'PAUSED'}), DELETE to remove. Does anything the token's scopes allow.

Inputs: path (required), method, params.

meta_list_ad_accountsA

[Meta] List ad accounts the token can access (id, name, status, spend, currency, business). NOTE: amount_spent is in the currency's MINOR unit (cents/pence) — divide by 100 for the real figure. (A SYSTEM-USER token returns [] here — use meta_graph on '/owned_ad_accounts' instead.) Start of an ads audit.

Inputs: no named parameters.

meta_list_businessesA

[Meta] List Business Manager businesses the token can access.

Inputs: no named parameters.

meta_list_campaignsA

[Meta] List campaigns on an ad account (id, name, status, effective_status, objective, budget, dates). NOTE: daily_budget/lifetime_budget are in the currency's MINOR unit (cents/pence — ÷100). The core tool for finding dead/clutter campaigns.

Inputs: adAccountId, limit.

meta_list_custom_audiencesA

[Meta] List custom audiences on an ad account (id, name, size, subtype, status, dates).

Inputs: adAccountId.

meta_list_pagesA

[Meta] List Facebook Pages the token manages (id, name, category, fans).

Inputs: no named parameters.

meta_list_pixelsA

[Meta] List ad pixels / datasets on an ad account (id, name, last_fired_time) — spot stale/duplicate pixels.

Inputs: adAccountId.

meta_page_insightsC

[Meta] Facebook Page insights (impressions, engagement, fans, etc.).

Inputs: metric (required), pageId, period, since, +1 more.

meta_update_campaignA

[Meta][WRITE] Change a campaign's status — ACTIVE / PAUSED / ARCHIVED / DELETED. The tidy verb for dead campaigns (prefer ARCHIVED over DELETED — reversible).

Inputs: campaignId (required), status (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 35 tools

    Disambiguation5/5

    Each tool is clearly prefixed by platform (ga4_, gbp_, gsc_, gtm_, meta_) and has a distinct purpose within that platform. No overlapping functionality between tools; even similar sounding tools like ga4_run_report and ga4_realtime are clearly differentiated by description.

    Naming Consistency5/5

    Naming follows a consistent pattern: platform_verb_noun (e.g., ga4_list_data_streams, gsc_submit_sitemap, meta_list_campaigns). All lowercase with underscores. Only minor exception is config_status without prefix, but it's a utility tool. Convention is uniform and predictable.

    Tool Count4/5

    35 tools is relatively high but justified by covering 5 distinct marketing platforms (GA4, GBP, GSC, GTM, Meta). Each platform has a reasonable number of tools (1-9), avoiding unnecessary bloat. Could be trimmed slightly, but overall appropriate for the scope.

    Completeness4/5

    The tool set covers core CRUD and reporting operations for each platform: GA4 has admin and data tools, GBP has location and review management, GSC has site and search analytics, Meta has ads and pages. Minor gaps exist (e.g., individual campaign get, detailed GA4 event data), but the surface is comprehensive enough for most marketing tasks.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables querying and analyzing marketing data from Google Analytics 4, Search Console, YouTube, and optionally Google Ads and Meta Ads, stored in a unified DuckDB database, via natural language in Claude.
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Gives Claude read access to Google Analytics 4, Google Search Console, and Microsoft Clarity data, with connections stored once and reusable across projects.
      8
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Connects Claude to Google Search Console, GA4, Bing Webmaster Tools, IndexNow, PageSpeed Insights, AdSense and Google Ads Keyword Planner, plus live technical SEO audits of pages and sitemaps. Users ask plain-language questions about traffic drops, index status, canonicals, AI referral traffic and keyword volumes, and answers are pulled live from the APIs in real time.
      28
      18 npm
      MIT