RoamSEO

Use RoamSEO with Claude

Add the RoamSEO connector to Claude, or install the plugin to get RoamSEO MCP and Agent Skills in Claude Code and Claude Cowork.

Quickest way: add the RoamSEO connector. It gives Claude RoamSEO's tools on the web, desktop and mobile, and in Cowork and Claude Code when you're signed in to the same Claude account. Sign in with your RoamSEO account when Claude asks. If the link doesn't open the listing, open Customize → Connectors in Claude, choose Add custom connector, and enter https://app.roamseo.com/mcp.

The connector doesn't include the SEO skills. To get them, install the RoamSEO plugin below instead. It includes the same tools, so you don't need both. Added under Customize → Plugins, it works in Claude chat, Cowork and Claude Code. On the Free plan, keep the connector and upload the skills instead.

Choose your setup path

Where you want to workHow to connect
Claude on the web, desktop or mobileAdd the RoamSEO connector
Claude CodeInstall the plugin
Claude CoworkInstall the plugin
The connector isn't availableAdd a custom connector

The RoamSEO plugin bundles RoamSEO MCP and all twelve SEO Agent Skills into one install. This is the preferred way to set up RoamSEO in Claude Code and in Claude Cowork.

Install in Claude Code

Run these two commands in Claude Code:

/plugin marketplace add roamseo/roamseo-plugins
/plugin install roamseo@roamseo

If the install summary says Run /reload-plugins to activate., run that command.

Claude Code connects RoamSEO MCP at https://app.roamseo.com/mcp and enables twelve skills:

  • SEO Project Setup
  • SEO Coach
  • SEO Audit
  • AI Visibility Audit
  • AI Prompt Research
  • Keyword Research
  • Keyword Clustering
  • Competitive Landscape
  • Competitor Analysis
  • Local SEO
  • Link Prospecting
  • SEO Report

MCP only in Claude Code

Use this if you want RoamSEO's tools without the skills. Use user scope to make RoamSEO available across projects. Use local scope for the current repository.

claude mcp add --transport http --scope user roamseo https://app.roamseo.com/mcp

After adding the server, approve the RoamSEO login when prompted. To use an API key instead of signing in, see Connect with an API key.

Finish the login

Claude Code should prompt you to log in to RoamSEO right after install. If it doesn't, run /mcp and approve the RoamSEO connection from there.

Run a skill

In Claude Code, plugin skills are namespaced by the plugin name:

/roamseo:seo-project-setup
/roamseo:seo-coach
/roamseo:seo-audit
/roamseo:ai-visibility-audit
/roamseo:ai-prompt-research
/roamseo:keyword-research
/roamseo:keyword-clustering
/roamseo:competitive-landscape
/roamseo:competitor-analysis
/roamseo:local-seo
/roamseo:link-prospecting
/roamseo:seo-report

Install in Claude Cowork

Claude Cowork and the Claude desktop app install plugins through the Customize menu, not slash commands. An agent can't click these steps for you.

  1. Open Customize in the left sidebar. In Cowork, open the Cowork tab first.
  2. Open Plugins, click + or Add, and choose Add marketplace.
  3. Choose Add from a repository and enter https://github.com/roamseo/roamseo-plugins.
  4. Find RoamSEO in the new marketplace and click Install or Add.
  5. Sign in to RoamSEO and approve the connection when Claude asks.
  6. Start a new task, type /, and check that the RoamSEO skills appear. Then try "Use RoamSEO to check my connection and list my projects." This check uses no RoamSEO credits.

If Claude can list your projects but no RoamSEO skills appear under /, you have a connector, not the plugin. Install the plugin, then remove the RoamSEO connector under Customize → Connectors so you keep one connection.

Plugins need a paid Claude plan (Pro, Max, Team, or Enterprise). Your organization can limit which marketplaces you can add. On the Free plan, add the RoamSEO connector and upload the skills under Customize → Skills. See Anthropic's plugin guide.

Custom connector

Use a custom connector if the RoamSEO connector isn't available to you. It gives Claude RoamSEO's tools but not the SEO skills. Claude labels custom connectors Custom and doesn't suggest them in chats, so use the RoamSEO connector when you can.

  1. Open Customize -> Connectors.
  2. Click Add (or +), then choose Add custom connector.
  3. Paste https://app.roamseo.com/mcp.
  4. Approve the RoamSEO login when prompted.

Claude Desktop custom connectors are available on Free, Pro, Max, Team, and Enterprise plans. Free plans support one custom connector. To add the skills without the plugin, upload them under Customize → Skills.

Update

Run inside Claude Code:

/plugin marketplace update roamseo
/plugin update roamseo@roamseo
/reload-plugins

Updates land in the cache immediately, but the running session keeps the old version until you run /reload-plugins or restart Claude Code.

You can enable automatic updates in /plugin → Marketplaces → roamseo → Enable auto-update. Third-party marketplaces have this off by default. Reload when Claude prompts you to activate an update. See Claude's plugin update documentation.

For other installation methods, see Agent setup and skill updates.

Remove

/plugin uninstall roamseo@roamseo

Troubleshooting

To check what's actually installed, run /plugin list rather than bare /plugin — /plugin alone opens an interactive panel that doesn't show plain text.

If /reload-plugins reports 0 skills, that's normal, not a failure — its summary only counts a plugin's commands/ directory, not skills/. Confirm the skills loaded by running one directly, for example /roamseo:seo-audit.

If /plugin uninstall roamseo@roamseo reports "not installed in this project," you likely installed to a different scope than the one being checked (User, Project, or Local). Run /plugin list to see the actual scope, or sidestep the picker entirely with the shell form: claude plugin uninstall roamseo@roamseo --scope user.

If plugin skills don't appear, clear the plugin cache with rm -rf ~/.claude/plugins/cache — this clears every installed plugin's cache, not just RoamSEO's, so reinstall anything else you have after — then restart Claude Code and reinstall the plugin.

If the RoamSEO connection doesn't show as authenticated, run /mcp, select RoamSEO, and complete the login.

Other clients

This page covers Claude. For Codex in the CLI or the ChatGPT desktop app, see Use RoamSEO with Codex. For ChatGPT, see the ChatGPT guide. For Cursor or an API key setup, see Set up RoamSEO MCP and Set up RoamSEO Agent Skills.