How do you connect Claude to SEMrush?

If you're tired of copying data between SEMrush and your AI tools, the SEMrush MCP integration is what closes that gap. It lets Claude query live SEMrush data directly inside your conversations, replacing the usual cycle of dashboard exports and manual reformatting. This page explains what the integration actually does and how to get it running.
Contributed by
SaaS Hackers
No items found.
No items found.
Blog

Quick Answer: You can connect Claude to SEMrush using the SEMrush Model Context Protocol (MCP) server. Once configured, Claude pulls live SEMrush data directly into your conversations, so you can run domain overviews, keyword gap analyses, and backlink audits without switching tabs or exporting CSVs.

B2B SaaS teams waste hours bouncing between SEMrush dashboards and their AI tools, copying data, reformatting reports, and losing context. The SEMrush MCP integration fixes that. Once connected, Claude becomes an SEO analyst that works directly from live SEMrush data, not cached summaries or hallucinated estimates.

This guide walks through the exact setup process and shows you three high-value workflows SaaS Hackers recommends for B2B SaaS teams: domain overviews, keyword gap analysis, and backlink pulls.

What Is the SEMrush MCP and Why Does It Matter?

Model Context Protocol (MCP) is an open standard that lets AI models like Claude connect to external tools and data sources in real time. The SEMrush MCP server is SEMrush's official implementation of that protocol.

Without MCP, Claude can only work with data you paste into the chat. With MCP, Claude queries SEMrush's API directly during your conversation and returns live, structured results. The difference is significant: you get accurate, current data instead of Claude estimating from training data that may be months out of date.

For B2B SaaS teams, this means you can ask Claude to compare your domain against three competitors, identify keyword gaps, and surface backlink opportunities, all in a single workflow without touching the SEMrush interface. If you need specialist support turning those insights into execution, SaaS Hackers also maintains curated lists of B2B SaaS SEO agencies and vetted B2B SaaS SEO experts.

What You Need Before You Start

Before configuring the integration, make sure you have the following in place:

  • A Claude Pro, Team, or Enterprise subscription. The MCP feature requires a paid Claude plan. Free accounts do not support custom MCP connections.
  • A SEMrush account with API access. API access is available on Guru and Business plans. Pro plan users do not get API access by default.
  • Your SEMrush API key. Find this under your SEMrush profile settings at semrush.com/accounts/profile/api.
  • Node.js installed (version 18 or later) if you are running the MCP server locally.

How to Connect Claude to SEMrush: Step-by-Step

Step 1: Get Your SEMrush API Key

Log into SEMrush and navigate to your account profile. Select Subscription Info, then scroll to the API section. Copy your API key and store it somewhere accessible. You will need it in Step 3.

Step 2: Open Claude's MCP Settings

In Claude (desktop app or web), open Settings, then navigate to Integrations or MCP Servers, depending on your version. This is where you add external MCP server configurations.

If you are using the Claude desktop app, locate the configuration file at:

  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Step 3: Add the SEMrush MCP Server Configuration

Open the config file and add the following JSON block inside the mcpServers object:

{
  "mcpServers": {
    "semrush": {
      "command": "npx",
      "args": ["-y", "@semrush/mcp-server"],
      "env": {
        "SEMRUSH_API_KEY": "your_api_key_here"
      }
    }
  }
}

Replace your_api_key_here with the API key you copied in Step 1. Save the file.

Step 4: Restart Claude

Close and reopen the Claude desktop app. Claude will detect the new MCP server configuration on startup. You should see a small tools icon or an indicator that SEMrush is connected in your conversation interface.

Step 5: Test the Connection

Start a new conversation and type:

"Using SEMrush, give me a domain overview for [yourdomain.com]"

If the connection is working, Claude will query SEMrush in real time and return organic traffic estimates, keyword counts, authority scores, and trend data. If you see an error, double-check that your API key is correct and that your SEMrush plan includes API access.

Three SEO Workflows to Run Once You're Connected

These are the three workflows SaaS Hackers recommends for B2B SaaS teams getting started with the Claude and SEMrush integration. Each one replaces a manual process that typically takes 20-40 minutes in the SEMrush dashboard.

Workflow 1: Domain Overview in Seconds

A domain overview gives you a snapshot of any site's organic performance. In SEMrush, pulling this manually means navigating to the Domain Overview tool, entering a URL, waiting for results, and then interpreting the data yourself.

With Claude connected to SEMrush, the same analysis takes one prompt:

Prompt to use:

"Pull a domain overview for [competitor.com] using SEMrush. Summarise their organic traffic trend over the last 6 months, their top 10 keywords by traffic, and their authority score. Flag anything that looks unusual."

Claude fetches the data, structures the output, and adds interpretation. You get a ready-to-use competitive snapshot without opening the SEMrush dashboard.

What this replaces: 25-30 minutes of manual data collection and formatting.

Workflow 2: Keyword Gap Analysis Against Competitors

Keyword gap analysis identifies keywords your competitors rank for that you do not. This is one of the most valuable SEO workflows for B2B SaaS teams targeting specific buyer personas, but it is also one of the most time-consuming to do manually. It becomes even more useful when paired with a stronger B2B SaaS content marketing strategy so those gaps can be turned into publishable content quickly.

Prompt to use:

"Using SEMrush, run a keyword gap analysis between [yourdomain.com] and [competitor1.com] and [competitor2.com]. Focus on keywords where both competitors rank in the top 20 but we do not appear at all. Filter for keywords with a monthly search volume above 100 and a keyword difficulty below 60. Group the results by topic cluster."

Claude pulls the gap data, filters it to your specifications, and organises the results by theme. You can follow up with:

"Which of these keyword clusters map to our mid-funnel content? Suggest a content brief for the highest-priority gap."

This turns a two-tool workflow (SEMrush plus a separate content planning doc) into a single conversation.

What this replaces: 40+ minutes of exporting, filtering, and manually grouping keyword data.

Workflow 3: Backlink Profile Pull and Opportunity Identification

Backlink analysis in SEMrush gives you the full picture of who links to a domain, the authority of those links, and the anchor text distribution. For B2B SaaS teams building link acquisition pipelines, this data is essential.

Prompt to use:

"Using SEMrush, pull the backlink profile for [competitor.com]. Identify the top 20 referring domains by authority score. Then cross-reference that list against our own backlink profile at [yourdomain.com] and flag any domains that link to them but not to us. These are our priority link targets."

Claude runs the comparison and returns a prioritised list of link acquisition targets. You can then prompt:

"For each of these referring domains, what type of content did they link to on [competitor.com]? Identify the content format pattern so we know what to pitch."

What this replaces: 35-45 minutes of manual backlink export, deduplication, and content research across multiple SEMrush reports.

Common Issues and How to Fix Them

Claude says it cannot access SEMrush data. Check that the MCP server configuration file is correctly formatted JSON. A missing comma or bracket will prevent the server from loading. Use a JSON validator before restarting Claude.

API key not recognised. Confirm your SEMrush plan includes API access. Guru and Business plans include this. Pro plan users need to upgrade or purchase API units separately.

Results look outdated or incomplete. SEMrush data is updated on a rolling basis. Some metrics (particularly backlink data) may lag by a few days. This is a SEMrush data freshness issue, not a connection problem.

Node.js errors on startup. Ensure you have Node.js version 18 or later installed. Run node --version in your terminal to check. If you are on an older version, update via the official Node.js site.

How We Recommend Using This Integration at SaaS Hackers

At SaaS Hackers, we treat the Claude and SEMrush connection as a research layer, not a replacement for SEO judgement. Claude surfaces the data and patterns. Your team interprets what they mean for your specific positioning, ICP, and content strategy.

The biggest gain is not speed alone. It is the ability to keep context across a research session. When you run a domain overview, a keyword gap, and a backlink pull in the same Claude conversation, Claude can connect the dots between all three datasets. That kind of cross-analysis would take multiple SEMrush reports and a separate synthesis step if done manually.

For B2B SaaS teams with lean marketing functions, this integration effectively adds an SEO research capability without adding headcount. Teams that want help operationalising those insights across organic, paid, and reporting workflows may also want to review B2B SaaS performance marketing agencies or broader B2B SaaS digital marketing agencies.

FAQs

What Claude plan do I need to connect to SEMrush via MCP? You need a Claude Pro, Team, or Enterprise subscription. The MCP integration is not available on the free Claude plan. Claude Pro starts at $20 per month and is sufficient for individual use. Teams and agencies should consider the Team plan for shared access.

Do I need a SEMrush API plan to use the MCP integration? Yes. SEMrush API access is included on Guru and Business plans. If you are on a Pro plan, you will need to either upgrade your subscription or purchase API units separately through SEMrush. Check your current plan at semrush.com/accounts/profile/api before attempting the setup.

Can Claude replace SEMrush entirely once they are connected? No. Claude uses SEMrush as its data source through the MCP connection. SEMrush still collects, processes, and stores all the underlying SEO data. What Claude adds is a natural language interface for querying that data, interpreting results, and connecting insights across multiple reports in a single conversation.

How many SEMrush API units does each Claude query use? This depends on the type of request. A domain overview query typically uses 10 API units. A keyword gap analysis or backlink pull may use more depending on the volume of results returned. Monitor your API usage in the SEMrush dashboard, particularly in the first week of use, to understand your consumption rate.

Is the SEMrush MCP integration safe to use with client data? The MCP connection queries SEMrush's API using your API key. Data flows between SEMrush's servers and Claude's processing environment. Review Anthropic's data handling policies and SEMrush's API terms before using the integration with sensitive client data, particularly if you operate under GDPR or similar data regulations.

No items found.
AI

Find a B2B SaaS Expert

We've collected a directory of B2B SaaS experts and agencies that we've reviewed and categorised based on service and specialism for your review.

SaaS Hackers character line up

More from the blog