SEO Analytics MCP Server

MCP server for Google Analytics 4 and Search Console. Deploys to Railway and connects to Claude as a custom connector.

Tools

Related MCP server: Google Search Console + GA4 MCP Server

Setup

1. Google Cloud project

1. Go to console.cloud.google.com and create a project (or use an existing one).

2. Enable these APIs:

   • Google Analytics Data API

   • Google Search Console API

   • Web Search Analytics API

3. Go to IAM & Admin → Service Accounts → Create Service Account.

4. Name it (e.g. seo-mcp), skip optional fields, click Done.

5. Click the service account → Keys → Add Key → JSON. Download the file.

6. Keep the client_email from the JSON — you'll need it for steps below.

2. Grant the service account access

Google Analytics 4:

1. Open GA4 → Admin → Property → Property Access Management.

2. Click + → Add user → paste the client_email.

3. Set role to Viewer.

Google Search Console:

1. Open Search Console → Settings → Users and permissions.

2. Click Add user → paste the client_email.

3. Set permission to Full (required for sitemap submit/delete).

3. Find your IDs

• GA4 Property ID: GA4 Admin → Property Settings → Property ID (numeric only, e.g. 123456789)

• GSC Site URL: Exactly as it appears in Search Console (e.g. https://example.com/ with trailing slash, or sc-domain:example.com for domain properties)

4. Deploy to Railway

1. Push this repo to GitHub.

2. Go to railway.app → New Project → Deploy from GitHub repo → select this repo.

3. Railway will detect Node.js and run npm install && npm run build automatically.

4. Go to Variables and add:

MCP_AUTH_TOKEN        = <generate with: openssl rand -hex 32>
GOOGLE_CREDENTIALS_JSON = <paste the entire contents of your service account JSON key, minified to one line>
GA4_PROPERTY_ID       = 123456789
GSC_SITE_URL          = https://example.com/

To minify the credentials JSON to one line (Mac/Linux):

cat your-key-file.json | jq -c . | pbcopy

5. Deploy. Railway will give you a public domain like https://seo-mcp-production.up.railway.app.

6. Test the health check:

curl https://your-railway-domain.up.railway.app/health

5. Connect to Claude

Claude Pro/Max (personal):

1. Open Claude → Customize → Connectors → + Add custom connector

2. Enter your Railway URL: https://your-railway-domain.up.railway.app/mcp

3. Add the Authorization header: Bearer your-mcp-auth-token

Claude Team/Enterprise:

• Owner adds it under Organization Settings → Connectors

6. Test in Claude

Enable the connector in a chat and try:

What are my top 10 landing pages by sessions for the last 28 days?

Show me my GSC performance for the past 30 days, grouped by query.

Inspect https://example.com/blog/my-post

List all my submitted sitemaps.

Local development

cp .env.example .env
# Fill in .env with your real values

npm install
npm run dev

Test locally:

curl -X POST http://localhost:3000/mcp \
  -H "Authorization: Bearer your-token" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Environment variables