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)

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.

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_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) | | 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). |

Security

• Credentials live only at ~/.oqva-marketing-mcp/.env on your machine, and go only to Google and Meta.
• 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.