OQVA Marketing MCP
OfficialThis MCP server connects Claude to Google and Meta marketing platforms for data retrieval, analysis, automation, and management.
Configuration & Health: Check connected data sources with
config_status, verify connections withdoctor, and re-authenticate accounts.Google Search Console: Query search analytics (clicks, impressions, CTR, position) with filters; list, submit, and delete sitemaps; inspect URL indexing; add sites; request indexing.
Google Analytics 4: Run flexible custom reports (sessions, users, conversions, events); view real‑time active users; admin capabilities: list accounts/properties, manage key events and custom dimensions, list data streams, and access full Admin API.
Google Tag Manager: Full API access to browse accounts/containers, manage tags/triggers/variables, create versions, and publish containers live.
Google Business Profile: List accounts and locations; get details; update info (categories, phone, hours, services) with dry‑run; fetch performance metrics (impressions, calls, clicks, directions); list and reply to reviews; search categories and places.
Meta (Facebook & Instagram): Retrieve page and ad insights (impressions, engagement, fans, spend, actions); list ad accounts, businesses, pages, campaigns, custom audiences, pixels; update campaign statuses (pause/archive/activate); delete custom audiences; perform raw Graph/Marketing API calls (GET, POST, DELETE).
Write operations are clearly marked; Claude confirms destructive or public actions. Credentials stored locally.
Provides integration with Google Analytics 4 for running reports, realtime data, managing key events, custom dimensions, and data streams.
Enables search analytics queries, sitemap management, URL inspection, and indexing requests via Google Search Console.
Integrates with Google Tag Manager for managing tags, triggers, variables, and publishing workspaces.
Integrates with Meta (Facebook and Instagram) for page insights, ad management, campaign control, and raw Graph API access.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@OQVA Marketing MCP Show my top Google Search Console queries from last month"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 setupInstalling 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-inTools
Tool | What it does |
| Which sources are configured (no secrets shown). Call first if something says "not configured". |
| Properties the OAuth account can read (confirms access + exact |
| Search Analytics — clicks/impressions/CTR/position by query/page/country/device/date. Live + filterable. |
| Submitted sitemaps + status. |
| Index/coverage/canonical for one URL. |
| GA4 Data API: sessions/users/conversions/events by any dimensions, any date range. |
| Active users in the last 30 min. |
| Business Profile accounts + locations. (needs GBP API approval) |
| One location in full — description, hours, service area, service items. (needs approval) |
| Look up a category id by display name ( |
| Look up Google Place IDs for a |
| [write] Edit categories, phone, website, description, hours, service area, services. Supports |
| Daily impressions/calls/website-clicks/directions for a location. (needs approval) |
| Reviews (rating, text, reply). (needs approval) |
| [write] Reply to a review. (needs approval) |
| Attributes the category allows vs. the ones actually set. |
| [write] Set/clear profile attributes (booking link, socials, "online estimates"…). |
| Google Posts on the profile (v4 API). (No Q&A tools: Google shut the Q&A API down on 2025-11-03.) |
| [write] Publish / remove a Google Post (summary + CTA button + photo). |
| [write-capable] Raw Meta Graph/Marketing API call — GET / POST / DELETE escape hatch. |
| Facebook Page insights. |
| Ad-account insights (only if you run Meta ads). |
| Enumerate Meta assets (ads audit). |
| List campaigns / audiences / pixels on an ad account. |
| [write] pause / archive / activate a campaign. |
| [write] delete a custom audience. |
| List your GA4 accounts/properties + their numeric ids. |
| [write] read / create Key events (conversions). |
| [write] read / create custom dimensions. |
| List data streams (+ measurement ids). |
| [write] GA4 Admin API escape hatch (audiences, property/stream edits). |
| [write] manage sitemaps + properties. |
| [write] request a recrawl (Indexing API). |
| [write + publish] Google Tag Manager API escape hatch (tags/triggers/variables → version → publish). |
| Keyword search volumes + CPC + competition + 12-month trend, batched 500/call. (needs |
| Live top-10 organic Google results for a keyword, plus whether ads share the SERP. (needs DataForSEO) |
| Mine Google autocomplete around a seed topic — what people actually type. Free, no key. |
| 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/.envon 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 serverRelease 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 toolsconfig_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
Scored across 35 tools
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 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.
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.
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
Related MCP Connectors
Read-only Google Ads, GA4 and Search Console data for Claude, with no Google Cloud setup.
GA4, Google Ads and Search Console in Claude. Read-only OAuth, multi-account for agencies.
Google Ads, Microsoft Advertising, GA4 and Search Console in Claude. Connect an ad account first.
Meta, TikTok, LinkedIn, Snapchat and Reddit ads in Claude. Connect an ad account first.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables natural language querying of Google Analytics 4, Google Search Console, Meta Ads, and Google Ads data through Claude.23-
- AlicenseNot gradedqualityBmaintenanceEnables 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.1MIT
- AlicenseAqualityCmaintenanceGives Claude read access to Google Analytics 4, Google Search Console, and Microsoft Clarity data, with connections stored once and reusable across projects.8MIT
- AlicenseBqualityCmaintenanceConnects 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.2818 npmMIT