OpenLens

OpenLens MCP + Claude Desktop: Integration Guide

Add the OpenLens Model Context Protocol server to Claude Desktop as a custom connector. After OAuth sign-in, Claude can run visibility scans, pull citations, manage projects, and schedule recurring runs directly from chat. Works for Claude Free and Pro.

On Claude.ai Team or Enterprise (the web app), use the Claude.ai integration guide instead.

TL;DR

Server URLhttps://openlens.com/mcp
TransportStreamable HTTP
AuthOAuth 2.1 (browser flow)
WhereSettings to Connectors to Add custom connector

Add the connector

  1. Open Claude Desktop and click Settings.
  2. In the sidebar, click Connectors.
  3. Click Add custom connector.
  4. Enter the server URL: https://openlens.com/mcp
  5. Click Connect.

Complete OAuth

Claude Desktop opens a browser tab for the Clerk OAuth handshake. Sign in with your OpenLens account and approve. Once the tab closes, the connector shows as connected in Settings and the tools are available in any new chat.

Verify it works

Open a new chat in Claude Desktop and ask:

“List my OpenLens projects.”

Claude will call list_projects and surface at least one row. If the tool call never fires, see Troubleshooting below.

What you can do once connected

The OpenLens MCP server exposes ~40 tools across project setup, brands, topics, prompts, runs, visibility analytics, citations, workstreams, and scheduling. Useful prompts include:

  • “Show me the biggest share-of-voice gaps for Lumen on ChatGPT this month and suggest topics that could close them.”
  • “Schedule a weekly scan for project Lumen every Monday morning and email me when it finishes.”
  • “Generate a brand health report for the last 30 days across all platforms, formatted as a one-page brief.”
  • “Add Substack and Reddit as competitor domains for the Lumen workstream and re-run topic-level visibility.”

Troubleshooting

  • Connector shows as “disconnected”: click the connector in Settings, hit Disconnect, then reconnect. The OAuth token may have expired.
  • “Add custom connector” option missing: update Claude Desktop to the latest version. Custom connectors require a recent build.
  • Tools never appear in chat: start a brand new conversation. Claude only loads connector tools at the start of a chat.
  • Anything else: email [email protected] with your Claude Desktop version and the exact error.

Related