Connect Google
Settings, Google Integrations card. Search Console and GA4 are separate connections. Connect either or both, with the same Google account or different ones, and disconnect them independently.- Organization owners and admins make the connection. One connection covers every project in the organization.
- The Google account needs Owner or Full access on the Search Console property, and read access on the GA4 property.
- The scopes are read-only. OpenLens never changes anything in your Google account.
On the GA4 consent screen, Google currently shows an unverified-app warning. Click Advanced, then continue. Verification is in progress with Google, and the warning has no effect on the data.
Point each project at its properties
The connection belongs to the organization. The properties belong to the project. In each project’s Settings, pick that project’s Search Console property and GA4 property from the dropdowns. Domain properties (sc-domain:) cover every subdomain and protocol, so use the domain property when you have one. Property selection is admins only. Viewing the data is open to anyone with access to the project, including users with the client role.
The Search & Traffic page
Every configured project gets a Search & Traffic page in the sidebar, with 7, 28, and 90 day windows. Google Search. Clicks, impressions, CTR, average position, the trend, and top pages and top queries. Two things to know when the numbers look off. Search Console data runs 2 to 3 days behind, and that lag is on Google’s side. And the headline totals match the GSC UI, while the tables count per page, so table columns can sum higher than the headline. Both are correct. AI Referral Traffic. Sessions and key events from AI referrers, split by platform (ChatGPT, Perplexity, Gemini, Claude, Copilot, Grok, DeepSeek), next to your site totals. Referrer attribution undercounts. Visits from native apps and pasted links carry no referrer at all. Treat the number as a floor.Ask the agent
The agent has both datasets as tools, and this is where the integration earns its keep. It can join Google data with visibility data and turn the answer into a deliverable. Asks that work today:- “Which pages get Google clicks but never show up as AI citations?”
- “Did the pages we rewrote in June move on impressions?”
- “Build a client-ready deck comparing our AI referral traffic to organic search over the last 90 days.”
Over MCP
The same two tools,get_gsc_search_analytics and get_ga4_ai_traffic, are exposed by the OpenLens MCP server. Claude Desktop, Cursor, anything that speaks MCP. See the MCP tools reference.
What we store
- OAuth tokens, encrypted. That is the whole footprint.
- Search Console and GA4 data is fetched from Google on demand and cached for about an hour. We never warehouse it.
- Disconnecting deletes the tokens and revokes OpenLens’s access at Google.