🚀 MCP by Amal Alexander

One AI Command. Four Platforms. Instant SEO Intelligence.

Connect Claude Desktop to Google Search Console · GA4 · Bing Webmaster Tools · Adobe Analytics
and ask questions in plain English, with no dashboards, no exports, and no switching tabs.

📚 Documentation · 🐛 Report Issue · 💼 LinkedIn · ✉️ Contact

🤔 What Is This?

This is a Model Context Protocol (MCP) server: a bridge that gives AI assistants direct, live access to your SEO data platforms.

Instead of:

• Logging into 4 dashboards

• Exporting CSVs

• Copy-pasting data into ChatGPT/Claude

• Waiting for reports

You just open Claude Desktop and ask:

"Why did my traffic drop last week and which pages are responsible?"

The MCP server fetches the live data, runs the analysis, and gives you an answer in seconds. No spreadsheets. No exports. No switching tabs.

Related MCP server: Google Search Console API MCP Server

🔌 Works With Claude Desktop (Primary) + Other MCP Clients

Important: This server uses the Model Context Protocol (MCP), an open standard by Anthropic. It is primarily designed for Claude Desktop, which has the most complete and polished MCP support. It also works with other MCP-compatible clients:

Not compatible with: ChatGPT, Gemini, raw API calls, or browser-based AI tools, as those do not support the MCP protocol.

✨ What You Can Do (Magic Prompts)

Paste any of these into Claude Desktop after setup:

"My traffic dropped this week, find exactly when it started and which pages are responsible."

"Find keywords where I rank 8-15 with over 1,000 impressions. These are my quick wins."

"Are any of my pages cannibalizing each other for the same keyword? Which should be primary?"

"Compare my Google vs Bing performance. Where am I stronger on Bing?"

"Run a full SEO health check. Give me 3 high-impact actions for this week."

"Which of my top pages have high impressions but terrible CTR? Fix the titles."

"Correlate my PageSpeed scores with ranking drops. Is slow speed hurting me?"

📦 Platforms Connected

⚡ Quick Start (5 Steps)

Requirements: Node.js 18+, npm, Windows/macOS/Linux, Claude Desktop installed

Step 1: Clone & Install

git clone https://github.com/amal-alexander/mcp.git
cd mcp
npm install

Step 2: Build

npm run build

Step 3: Run the Setup Wizard

node dist\index.js setup

You'll see an interactive menu:

╭──────────────────────────────────────────────╮
│              MCP: Setup Wizard               │
│  GSC · Google Analytics 4 · Bing · Adobe     │
│            Built by Amal Alexander            │
╰──────────────────────────────────────────────╯

Let's wire this up. Pick your integration.

1. Google Search Console
2. Google Analytics 4
3. Bing Webmaster Tools
4. Adobe Analytics
5. Exit

Pick each platform you want to connect. You can run it multiple times to add more.

Step 4: Add to Claude Desktop Config

The wizard prints the exact JSON to paste. Open this file:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Paste this:

{
  "mcpServers": {
    "mcp-amal-alexander": {
      "command": "node",
      "args": ["C:/full/path/to/mcp/dist/index.js"]
    }
  }
}

Use forward slashes in the path, even on Windows. Replace with your actual clone location.

Step 5: Restart Claude Desktop & Test

Restart Claude Desktop. You'll see the 🔧 tools icon appear. Then ask:

"List my top 10 pages by impressions from Google Search Console for the last 30 days."

If you get data back: you're live! 🎉

🛠️ Platform Setup Details

Option A: OAuth (Easiest, Personal Accounts)

1. Run node dist\index.js setup -> select 1. Google Search Console

2. Choose Login with Google (OAuth 2.0)

3. Your browser opens -> sign in -> grant access

4. Done, tokens are saved to the system keychain automatically

Option B: Service Account (Teams / CI)

1. Go to Google Cloud Console -> Service Accounts

2. Create service account -> Keys -> Add Key -> JSON -> download

3. In Search Console -> Settings -> Users and permissions -> Add user -> paste service account email -> Full permission

4. Run setup -> select Setup Service Account -> paste the JSON file path

1. Use the same service account JSON from GSC (the wizard offers to reuse it)

2. In GA4 -> Admin -> Property Access Management -> + Add users -> paste service account email -> Viewer role

3. Run setup -> select 2. Google Analytics 4 -> wizard auto-fetches your properties

1. Go to Bing Webmaster Tools -> Settings -> API Access

2. Copy your API Key

3. Run setup -> select 3. Bing Webmaster Tools -> paste the key

Or set via CMD:

setx BING_API_KEY "your-api-key-here"

1. Go to Adobe Developer Console

2. Create project -> Add to Project -> API -> Adobe Analytics

3. Select OAuth Server-to-Server -> Save configured API

4. Copy: Client ID, Client Secret, IMS Org ID (top-right of console.adobe.com)

5. Find your Report Suite ID in Adobe Analytics -> Admin -> Report Suites

6. Run setup -> select 4. Adobe Analytics -> paste each value

Or run directly:

node dist\index.js setup --engine=adobe

📊 Expected Output When Connected

Here's what Claude can tell you the moment it's connected:

You: "Run a health check on my site."

Claude: Here's your SEO health check for example.com (last 28 days):

📈 Performance Overview
  • Total Clicks: 12,450 (+8.3% vs previous period)
  • Total Impressions: 284,000 (+2.1%)
  • Average CTR: 4.38% (down from 4.71%)
  • Average Position: 18.4

⚠️ Anomalies Detected
  • Traffic drop on June 14: clicks fell 34% on /blog/guides/*
  • Correlates with Google algorithm update (June 13)

🎯 Top 3 Quick Wins
  1. /pricing: ranking #9 with 8,200 impressions. One push to top-5 = ~3,200 extra clicks/month
  2. /features: CTR of 1.2% at position #3, meta description likely needs rewriting
  3. /blog/seo-tips is cannibalized by /resources/seo-guide, consolidate these pages

🛡️ Security & Privacy

• 100% Local: all credentials stay on your machine. Zero cloud storage.

• System Keychain: Google tokens stored in Windows Credential Manager / macOS Keychain

• AES-256-GCM Encryption: all other credentials encrypted with your hardware machine ID

• No middleman: API calls go directly from your machine to Google/Bing/Adobe

🔧 Troubleshooting

🗺️ Full Tools Reference

Google Search Console

Google Analytics 4

Bing Webmaster Tools

Cross-Platform Intelligence

🏗️ Architecture

graph TD
    Claude[Claude Desktop ⭐] -- MCP Stdio --> Server[MCP Server]
    Cursor[Cursor IDE] -- MCP Stdio --> Server
    Server -- Keychain API --> Keys[System Keychain]
    Server -- AES-256-GCM --> Enc[Encrypted Config]
    Server --> GSC[Google Search Console API]
    Server --> GA4[Google Analytics 4 API]
    Server --> Bing[Bing Webmaster API]
    Server --> Adobe[Adobe Analytics API]

Built with ❤️ by Amal Alexander

If this saved you time, please ⭐ the repo — it helps others find it!

⭐ Star on GitHub · 💼 Connect on LinkedIn