Skip to main content
Glama
oqva-digital

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)

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: GSC MCP Server v2 - Remote Edition

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.

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/oqva-digital/oqva-marketing-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server