SEO Heatmap MCP server for Claude, ChatGPT and Codex

Connect your SEO Heatmap account to an AI assistant and ask about your Google Search Console clicks in plain English. It reads the same complete, page-by-page history you see in the heatmap (16 months, 16 weeks), so answers come back fast and match your dashboard.

Server URL

https://www.getseoheatmap.com/mcp

You need an SEO Heatmap account with at least one synced site. Open the dashboard to sync one.

What you can ask

“Which blog posts lost the most clicks last month? Is it a one-off or a trend?”
“Show me pages that have been falling for 3 months in a row.”
“Which sections of my site grew year over year?”
“Give me a content-refresh shortlist: pages far below their peak.”

What the AI gets: 8 tools

Instead of raw Search Console rows, the AI calls tools that return finished answers computed from your heatmap data.

list_sites Lists your synced sites and when each was last synced.
get_site_overview One-call health check: totals, change vs the previous period and last year, top movers and sections.
find_pages Filters and sorts pages by URL, trend and clicks, like the heatmap.
compare_periods Explains a change between two periods: who gained, who lost, what appeared or disappeared.
get_page_history One page's monthly, weekly and quarterly clicks, its peak and its current trend.
find_opportunities Shortlists of decaying, lost, new and rising pages, each with a reason.
get_sections Rolls pages up by folder (/blog/, /docs/) to show which parts of the site move.
refresh_site_data Starts or reports today's update of a site from Search Console (each site is updated once a day).

Set it up

Claude (web and desktop)

Open Claude’s connector settings (Customize → Connectors).
Click “+”, then “Add custom connector”.
Name it “SEO Heatmap”, paste the server URL and click “Add”.
Click “Connect”, sign in to SEO Heatmap and click “Approve”.

Works on every Claude plan, on the web and in Claude Desktop. The free plan allows one custom connector. Open Claude connector settings

ChatGPT

Open ChatGPT’s Plugins page (chatgpt.com/plugins) in a web browser. The desktop and mobile apps can’t add custom plugins.
Click “Add” (top right), then “Create MCP App”.
Name it “SEO Heatmap”, paste the server URL, choose OAuth as the authentication and click “Create”.
Sign in to SEO Heatmap and click “Approve”.

Needs a paid ChatGPT plan (Plus, Pro, Business, Enterprise or Edu). If “Create MCP App” is missing, turn on Developer mode in ChatGPT’s settings first. Open ChatGPT plugins

Claude Code

claude mcp add --transport http seo-heatmap https://www.getseoheatmap.com/mcp

Then run /mcp in Claude Code, pick seo-heatmap and choose “Authenticate”.

Codex

codex mcp add seo-heatmap --url https://www.getseoheatmap.com/mcp

codex mcp login seo-heatmap

Other MCP clients

Cursor, VS Code and other clients that support remote MCP servers with OAuth: add a server with the URL above and sign in when asked.

What the AI can and can’t do

It can read the sites you’ve synced and their click history, per page and per period.
It can refresh a site’s data from Search Console, at most once per site per day.
It can’t change anything in Google Search Console, and it can’t see anyone else’s data.
The data is clicks only: impressions, CTR, positions and queries aren’t included.

See our Privacy Policy.

Connected AI apps

Frequently asked questions

What is the SEO Heatmap MCP server?

A remote MCP (Model Context Protocol) server that gives AI assistants such as Claude, ChatGPT and Codex read access to the Google Search Console click data SEO Heatmap keeps for you: 16 months and 16 weeks of clicks per page, already turned into trends, winners and losers, and decaying pages.

How is it different from a Google Search Console MCP server?

A Search Console MCP server returns raw rows, so the AI has to page through row limits and do the math itself. SEO Heatmap returns finished answers computed from a complete page-by-period table, which is faster, uses fewer tokens and matches your dashboard. It covers clicks only, so pair it with a Search Console MCP server when you need queries, impressions or positions.

Is the MCP server free?

Yes. It is included with every SEO Heatmap plan, including the free one, for as many properties as your plan covers: 1 on Free, 3 on Business, unlimited on Agency.

Which AI apps can I connect?

Claude (web, desktop and Claude Code), ChatGPT on paid plans (added once through the web app at chatgpt.com/plugins), Codex, Cursor, VS Code and any other client that supports remote MCP servers with OAuth.

What can the AI see and do?

Only the sites you've synced to SEO Heatmap and their click history per page and period. It can't change anything in Google Search Console, can't see anyone else's data, and can refresh a site's data at most once per site per day.