marketing-mcp
Provides read-only access to Google Ads accounts and performance data, including listing customers, reporting performance by account, campaign, ad group, keyword, or search term, and running SELECT-only GAQL queries for metrics such as geo performance, conversions, and store visits.
Provides read-only access to Google Search Console data, including tools to list sites and query clicks, impressions, CTR, and average position by query, page, country, device, or date with filters.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
marketing-mcp
Pose tes questions marketing à Claude, il va chercher les chiffres lui-même.
marketing-mcp est un serveur MCP (Model Context Protocol) qui
donne à Claude un accès en lecture seule à tes données SEO et SEA :
Google Search Console, Google Ads et Bing Webmaster Tools.
Au lieu d'exporter des CSV, de croiser des onglets et de recopier des chiffres dans un rapport, tu demandes :
« Compare les performances des campagnes Search sur Tours, de janvier à septembre 2026, avec l'année dernière, et sors-moi les mots-clés qui génèrent des visites en magasin. »
Claude choisit les bons outils, interroge les API, calcule les écarts et répond avec un tableau.
Le serveur tourne sur ton poste : tes jetons restent dans des fichiers locaux, et les données ne passent par aucun service tiers en dehors des API Google et Microsoft elles-mêmes.
Ce qu'il sait faire
Source | Outils | Ce que tu peux demander |
Google Search Console |
| Clics, impressions, CTR et position par requête, page, pays, appareil ou date, avec filtres |
Google Ads |
| Performances par compte, campagne, groupe d'annonces, mot-clé ou terme de recherche ; toute requête GAQL |
Bing Webmaster Tools |
| Trafic Bing par jour, top requêtes et pages, exploration et indexation |
— |
| Quelles sources sont branchées, et comment brancher les autres |
GA4 et Meta Ads sont prévus (voir Feuille de route).
Détail de chaque outil, paramètres et sorties : docs/outils.md.
Exemples de questions
« Quelles sont mes 20 requêtes Search Console qui ont le plus progressé ce mois-ci sur
blog.exemple.fr? »« Sur Google Ads, quel est le coût par visite en magasin des campagnes Search ciblant Tours, et quels mots-clés les portent ? »
« Compare le trafic Bing et Google de
www.exemple.frsur les 3 derniers mois. »« Bing a-t-il des erreurs d'exploration ou des pages bloquées par robots.txt sur mon site ? »
Related MCP server: google-search-console
Comment ça marche
flowchart LR
U["Toi"] -->|question en français| C["Claude<br/>(Claude Code, app Claude)"]
C -->|appel d'outil MCP| S["marketing-mcp<br/>(sur ton poste, stdio)"]
S -->|OAuth 2.0 + PKCE| G["API Google<br/>Search Console · Google Ads"]
S -->|clé API| B["API Bing Webmaster"]
S -.->|lit| E[".env + data/<br/>(jamais versionnés)"]Transport stdio : Claude lance le serveur comme un programme local ; rien n'est exposé sur le réseau.
OAuth « application de bureau » avec PKCE : une commande ouvre le navigateur une seule fois, le refresh token est enregistré dans
data/google-token.json.Lecture seule garantie par le code : le serveur n'appelle que des méthodes de lecture (
searchAnalytics.query,googleAds:search, méthodesGet*de Bing) etgads_searchrefuse toute requête qui n'est pas unSELECT.Listes blanches : tu choisis dans
.envles sites et comptes interrogeables ; les autres sont refusés avant tout appel réseau.Sorties structurées : chaque outil déclare un schéma d'entrée et de sortie (zod), Claude reçoit du JSON typé.
Démarrage rapide
Prérequis
Node.js 22 ou plus
Claude Code (terminal, application de bureau ou extension d'IDE)
Pour Google : un projet Google Cloud avec un client OAuth de type « Application de bureau »
Pour Bing : un compte Bing Webmaster Tools
Installation
git clone https://github.com/Abdoul88/marketing-mcp.git
cd marketing-mcp
npm install
cp .env.example .envSous Windows PowerShell, remplace npm par npm.cmd (la stratégie d'exécution bloque npm.ps1)
et cp par copy.
Configuration
Remplis
.env: voir docs/installation.md, qui détaille pas à pas la création du projet Google Cloud, de l'écran de consentement, du client OAuth et de la clé Bing.Autorise ton compte Google :
npm run auth:googleOuvre Claude Code dans le dossier du projet :
.mcp.jsony déclare le serveur. Accepte de faire confiance au serveur du projet quand Claude Code le demande.Demande à Claude : « Quelles sources marketing sont disponibles ? »
Pour avoir le serveur dans toutes tes sessions, quel que soit le dossier :
claude mcp add marketing-mcp --scope user -- node /chemin/vers/marketing-mcp/node_modules/tsx/dist/cli.mjs /chemin/vers/marketing-mcp/src/index.tsConfiguration (.env)
Variable | Obligatoire | Rôle |
| pour Google | Client OAuth Google (application de bureau) |
| pour Google | Secret de ce client |
| non | Propriétés Search Console interrogeables, séparées par des virgules, écrites exactement comme dans Search Console ( |
| non | Compte administrateur (MCC) par lequel lire les comptes clients |
| non | Comptes Google Ads interrogeables (10 chiffres, tirets acceptés). Vide = tous. |
| non | Version de l'API Google Ads, défaut |
| non | Ignoré par Google depuis le 9 septembre 2026 ; envoyé seulement s'il est renseigné |
| pour Bing | Clé API Bing Webmaster Tools |
| non | Sites Bing interrogeables, séparés par des virgules, écrits comme dans Bing Webmaster. Vide = tous. |
Chaque source est indépendante : sans clé Bing, les outils Google fonctionnent, et inversement.
Sécurité et confidentialité
Aucun secret dans le dépôt.
.env(identifiants) etdata/(refresh token) sont dans.gitignore. Le fichier.env.examplene contient que des noms de variables.Lecture seule. Aucun outil ne crée, ne modifie ni ne supprime quoi que ce soit dans tes comptes. Le scope
adwords(Google Ads) n'a pas de variante lecture seule chez Google : c'est le serveur qui garantit la lecture seule, en n'exposant que des appels de lecture.Clés jamais affichées. La clé Bing voyage dans l'URL (c'est le fonctionnement de l'API Bing), mais les messages d'erreur ne la contiennent jamais ; un test le vérifie.
Mode « Test » Google. Tant que l'application OAuth est en mode Test, Google invalide le refresh token au bout de 7 jours : relance
npm run auth:google.
Développement
npm run typecheck # vérification TypeScript (strict)
npm test # tests vitest : un faux fetch simule Google et Bing, aucun appel réseau
npm start # lance le serveur à la main (stdio)
npm run auth:google # autorise le compte Googlesrc/
index.ts point d'entrée stdio : lit .env, assemble les clients, démarre le serveur
server.ts déclaration des outils MCP (schémas d'entrée/sortie, listes blanches)
sources.ts catalogue des sources et de leur état
config.ts lecture de .env, chemins du projet, normalisation des IDs Google Ads
google-auth.ts OAuth Google : URL d'autorisation (PKCE), refresh token, jeton d'accès
auth-google.ts commande « auth:google » (serveur local de rappel sur 127.0.0.1)
gsc.ts client Search Console
google-ads.ts client Google Ads (GAQL, pagination, erreurs) et rapport de performances
bing.ts client Bing Webmaster (clé API, dates WCF, cumul hebdomadaire)
tests/ vitest, un fichier par source + démarrage stdio réel depuis .mcp.json
docs/ guide d'installation et référence des outilsPour ajouter une source : un client dans src/<source>.ts (avec fetch injectable pour les
tests), sa configuration dans config.ts, ses outils dans server.ts, son état dans sources.ts,
puis un fichier de tests avec un faux fetch.
Dépannage
Message | Cause | Solution |
« Compte Google non autorisé » | Pas de |
|
« Autorisation Google expirée ou révoquée » | Application OAuth en mode Test (7 jours) ou accès retiré |
|
« L'autorisation Google actuelle n'inclut pas Google Ads » | Autorisation faite avant le connecteur Ads, ou accès décoché |
|
« n'a que l'accès Test » | Projet Cloud sans accès Explorer à l'API Google Ads | Demander l'accès Explorer (voir docs/installation.md) |
« Active Google Ads API » | API non activée dans le projet Cloud | L'activer dans la bibliothèque d'API |
| Compte géré via un MCC | Passer |
« Propriété / Compte / Site non autorisé » | Absent de la liste blanche | Ajouter à |
« Bing Webmaster n'est pas configuré » | Pas de | Générer la clé (voir docs/installation.md) |
Bing | Clé invalide ou révoquée | Régénérer la clé dans Bing Webmaster |
Les nouveaux outils n'apparaissent pas | Serveur chargé avant la modification | Ouvrir une nouvelle session Claude |
Feuille de route
Source | État |
Google Search Console | ✅ validé avec un vrai compte |
Google Ads (API v26) | ✅ validé avec un vrai compte (accès Explorer) |
Bing Webmaster Tools | ✅ validé avec une vraie clé API |
Google Analytics 4 | ⏳ prévu |
Meta Ads | ⏳ prévu |
Google Business Profile | ⏳ en attente de l'accès API Google |
Licence
MIT © 2026 Abdoul Diallo
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only Google Ads, GA4 and Search Console data for Claude, with no Google Cloud setup.
SEO research, Search Console, GA4 and PPC tools for Claude and ChatGPT.
GA4, Google Ads and Search Console in Claude. Read-only OAuth, multi-account for agencies.
Google Search Console, Bing, GA4 and SEO reports for Claude, ChatGPT and any MCP client
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Claude to access Google Search Console data including search performance, URL indexation, sitemaps, and built-in SEO analysis tools such as trending queries, cannibalization detection, and traffic drop diagnostics.101 npm10MIT
- AlicenseNot gradedqualityCmaintenanceEnables querying Google Search Console data, including search analytics, indexing status, and sitemap management, through natural language conversations with Claude.101 npm6MIT
- AlicenseCqualityCmaintenanceEnables Claude Code to read Google Search Console and GA4 data locally with read-only access, and provides combined SEO analysis tools for comparing datasets and identifying opportunities.20MIT
- AlicenseAqualityCmaintenanceEnables Claude to query Google Search Console performance data, inspect URL indexing status, submit URLs via IndexNow, and check title and meta-description lengths against Bing limits directly in chat.6MIT