Getting Started

Connecting Semrush MCP to your AI assistants takes just a few minutes. Follow the setup instructions for your specific AI platform below.

ChatGPT

1. Access the Semrush ChatGPT app
2. Click Connect to enable the app
3. In the modal, click Continue
4. Review the access details on the permission screen, then click Approve

To use the Semrush app within ChatGPT chats, tag it directly as @Semrush in your prompts.

Claude

1. Access the Semrush app inside Claude 
2. Click Connect to enable the app
3. Review the access details
4. Click Approve

To use the Semrush app within Claude chats, tag it directly as @Semrush and start asking questions.

Claude Code

1. Open your terminal and run this command: claude mcp add semrush https://mcp.semrush.com/v2/mcp -t http
2. Open Claude Code and run the /mcp command
3. Select Semrush MCP from the list of MCP integrations
4. Select Authenticate

Microsoft Copilot

Semrush MCP is available as an official app inside Microsoft Copilot.

1. Access Semrush MCP inside the Microsoft Marketplace
2. Click Get it now
3. Sign in to your Semrush account and approve access.

Please note that to use Semrush MCP, you need a Microsoft Copilot experience that supports MCP integrations (such as Microsoft 365 Copilot or an MCP-enabled Copilot environment) and permission to use third-party connectors in your organization.

Cursor

1. Open Cursor and go to Settings → Cursor Settings → Tools & MCP
2. Add the following Semrush MCP configuration to your Cursor MCP settings:

   {
     "mcpServers": {
       "semrush": {
         "url": "https://mcp.semrush.com/v2/mcp"
       }
     }
   }
   

    

3. Save the changes

VS Code

1. Create a .vscode/mcp.json file in your VS Code workspace
2. Add the following MCP configuration to the file:

   {
     "servers": {
       "semrush": {
         "url": "https://mcp.semrush.com/v2/mcp",
         "type": "http"
       }
     }
   }
   

    

3. Save the changes

Gemini

The Semrush MCP server authenticates with Gemini (Gemini CLI) using your Semrush API key.

1. Add the Semrush MCP server to Gemini. Open your terminal and run:

gemini mcp add --transport http \
  --header "Authorization: Apikey YOUR_API_KEY" \
  semrush https://mcp.semrush.com/v2/mcp

Replace YOUR_API_KEY with your actual Semrush API key.

2. Verify the server was added. Run:

gemini mcp list

You should see Semrush listed among your configured MCP servers.

Once added, the Semrush MCP server is available in Gemini CLI and can be used in your workflows.

Perplexity

1. Access the Semrush app inside Perplexity
2. Click Add connector to enable the app

3. Review the access details on the permission screen
4. Click Continue

Please note that you need a paid Perplexity account to add custom MCP connectors, including Semrush’s.

Notion

1. Go to the Notion Marketplace
2. Click Connections
3. Type Semrush in the search bar
4. Click Connect
5. Sign in to your Semrush account and approve access

Please note that you need an active Notion Business or Enterprise subscription to use Semrush MCP.