By Ira Bodnar, Ryze AI · Updated · Connector tested November 14, 2026
Quick answer
The main way to connect Gemini to Google Search Console is the Ryze AI connector. Link your Search Console login to a Ryze AI workspace and save the Site there, then paste https://connector.get-ryze.ai/mcp into the Gemini web app as a custom app under Settings, Connected Apps, and call it with @ in a prompt. Gemini CLI takes the same address through one gemini mcp add command. Gemini then reaches Search Console through 7 tools: 5 that read, 1 that submits a sitemap and 1 that removes one. Google opens custom apps only to people 18 or over in the US, on a personal Google Account, in English. Google lists no Search Console MCP server of its own.
- In Ryze AI open Integrations, find Google Search Console and click Connect
- Sign in with Google, approve access, then check the Site and click Save
- In gemini.google.com open Settings, Connected Apps, Add a custom app and paste the URL
- Sign in on the Ryze AI page, choose workspaces, click Allow connection, then type @ and pick Ryze AI
Gemini to Google Search Console at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector, added once per Gemini surface: a custom app in the web app, or one gemini mcp add command in Gemini CLI |
| Server address | https://connector.get-ryze.ai/mcp |
| Sign-in | Google inside Ryze AI, then Ryze AI from Gemini with no client ID to type. Gemini CLI can also send a Ryze AI API key as a header |
| Search Console tools | 7: listSites, runRawSearchAnalytics, inspectUrl, listSitemaps, getIndexationSummary, submitSitemap and deleteSitemap |
| Can Gemini change Search Console | Only sitemaps: submitSitemap adds or resubmits one and deleteSitemap removes one from Search Console. The other 5 tools read |
| Who may add a custom app | Adults 18 or over in the US with a personal Google Account, Keep Activity on and Gemini in English |
| Gemini plan needed | The custom apps page names none. Gemini CLI has not served Google AI Pro, Ultra or free Code Assist for individuals since June 18, 2026 |
| Search Console access needed | A Google login with access to a verified property. Owners and full users can submit sitemaps in the interface |
| Ryze AI price | SEO Starter is $129 per month with a 3-day free trial, and the 7 tools also work on Paid Ads at $89 per month with a 7-day trial. Adding the connector costs nothing |
| Google's own option for Gemini | None found. Google's list of remote MCP servers, its MCP repository and the Search Console API pages name no Search Console server |
| Last tested | Connector and 5 Search Console calls on November 14, 2026, sent from Claude Code. Nothing run inside Gemini |
Before you start
- A Gemini account that Google allows. Google's help page for custom apps asks for age 18 or over, a US location, a personal Google Account (a work or school account cannot add one) and Keep Activity switched on. The feature is English only, and the page names no paid plan.
- A Google login with access to a Search Console property. The property must be verified. Google describes owners as having full control, full users as able to view all data and take some actions, and restricted users as having view rights on most data. Ryze AI asks for the Search Console scope, so keep every requested permission checked on the Google screen.
- A Ryze AI workspace on a plan or free trial. SEO Starter is $129 per month with a 3-day free trial. The Search Console tools also run on Paid Ads, which is $89 per month with a 7-day free trial. Annual billing takes 30% off the first year. Connecting the connector is free; the tools need an active plan or trial.
- Trust in the server. Google states it does not control, monitor or secure third-party MCP servers, so you decide whether to trust a provider before you connect.
How to connect Gemini to Google Search Console in the web app
Setup has two parts. Search Console is connected inside Ryze AI first, then Gemini is pointed at the Ryze AI connector. Google lets you add custom apps only in the Gemini web app, on a computer or at gemini.google.com in a phone or tablet browser. After that they also work in the Gemini mobile app.
Connect Google Search Console in Ryze AI
Create a Ryze AI account or sign in and open Integrations in the left sidebar. Find Google Search Console with the Search integrations box or the Analytics filter and click Connect. Sign in to Google and approve access, keeping every requested permission checked.
Check the Site and save
Back in Ryze AI, look at the Site. Ryze AI pre-selects the property that matches the workspace domain; change it if needed and click Save. Until a Site is saved the card shows Require setup.
Open Connected Apps in Gemini
On a computer go to gemini.google.com and click Settings at the bottom, then Connected Apps. If Connected Apps is missing, click Personal Intelligence first. In a phone or tablet browser, Settings sits under Menu at the left.
Add a custom app with the Ryze AI URL
Under Custom apps use the Add a custom app link to get started field, or click Add a custom app if one is already connected. Enter https://connector.get-ryze.ai/mcp and click Next. Ryze AI supports dynamic client registration, so the credential fields under Advanced features, Show more stay empty.
Allow the workspace
Follow the on-screen instructions: sign in on the Ryze AI page, choose the workspaces that hold your Search Console connection and click Allow connection.
Use the app in a prompt
In a new prompt type @ and select the Ryze AI app, then ask a first question, for example: List the Search Console properties my login can access.
Sources: Google's Gemini help page on custom apps and its phone version. Checked November 14, 2026. The Ryze AI Google Search Console guide covers the Google sign-in on the Ryze AI side.
Gemini CLI
Gemini CLI reads MCP servers from the command line. This command registers the Ryze AI connector at user scope, so every project can use it (the default scope is project):
gemini mcp add --transport http -s user ryze https://connector.get-ryze.ai/mcpStart Gemini CLI. After a 401 it discovers OAuth, registers a client and opens a browser for the Ryze AI sign-in; /mcp auth ryze starts or repeats that sign-in. OAuth needs a local browser and a localhost callback, so it does not work in headless environments, in SSH sessions without X11 forwarding or in containers without a browser.
Prefer the settings file? Add this entry to settings.json:
{
"mcpServers": {
"ryze": { "httpUrl": "https://connector.get-ryze.ai/mcp" }
}
}On a machine without a browser, send a Ryze AI API key as a header instead of OAuth: gemini mcp add --transport http -s user --header "Authorization: Bearer rk_live_..." ryze https://connector.get-ryze.ai/mcp. The includeTools and excludeTools settings in settings.json decide which of the 7 tools Gemini CLI may call, so excludeTools can keep submitSitemap and deleteSitemap out of reach.
Source: Gemini CLI MCP server docs. Checked November 14, 2026.
Antigravity CLI and Gemini Enterprise
Antigravity CLI
Google's May 19, 2026 announcement says that since June 18, 2026 Gemini CLI no longer serves Google AI Pro and Ultra users, or people on the free Gemini Code Assist for individuals tier, and it points them to Antigravity CLI. Gemini CLI stays available with Gemini Code Assist Standard or Enterprise licenses and with paid Gemini or Gemini Enterprise Agent Platform API keys. This guide gives no Antigravity CLI steps.
Gemini Enterprise
Gemini Enterprise lets an administrator add custom MCP servers in the Google Cloud console. It takes StreamableHTTP only, keeps actions off until enabled, allows 100 at a time, and signs in with OAuth 2.0 using a pre-registered client ID and secret, or with no authentication. Ryze AI documents no such client, so this guide gives no Gemini Enterprise steps.
Sources: Google Developers Blog on Gemini CLI and Antigravity CLI, Gemini Enterprise custom MCP server setup. Checked November 14, 2026.
Gemini and MCP: Google's rules in one table
The Gemini app and Gemini CLI treat MCP servers differently. This table puts Google's documented rules for both in one place.
| Topic | Gemini web and mobile app | Gemini CLI |
|---|---|---|
| Where a server is added | Settings, Connected Apps, Custom apps (gemini.google.com/apps). A remote URL only, with no field for a command | gemini mcp add, or an mcpServers entry in ~/.gemini/settings.json (user) or .gemini/settings.json (project). A URL or a local program |
| Transport | The help page names none and asks only that the server follows the standard MCP specifications | stdio, SSE and Streamable HTTP. The add command assumes stdio unless --transport says otherwise |
| Sign-in | The URL alone when the server offers dynamic client registration; otherwise credentials under Advanced features. No header or API key field is documented | OAuth discovery after a 401, with tokens kept in ~/.gemini/mcp-oauth-tokens.json. A headers object or -H can carry an API key instead |
| Tool approval | Gemini asks you to confirm every write action by hand. The page says nothing separate about reads | A prompt on each call: Proceed once, Always allow this tool, Always allow this server or Cancel. trust: true skips the prompts |
| Narrowing the tools | Only the whole app can be switched off; no per-tool setting is described | includeTools and excludeTools (excludeTools wins), plus allow, deny or ask_user rules in ~/.gemini/policies/ |
| Plan | None named for custom apps. Tasks, which can also call a custom app, need Google AI Pro or Ultra | Code Assist Standard or Enterprise licenses and paid API keys keep access; Google AI Pro, Ultra and free Code Assist for individuals lost it on June 18, 2026 |
| Admin controls | None described, and work or school accounts cannot add custom apps for now | mcp.allowed and mcp.excluded, admin.mcp.enabled, and a system settings file whose servers a user cannot redefine |
| Where servers are managed | The Custom apps list: a switch to turn the app off, then More details for Disconnect or Remove app | /mcp list, /mcp auth, /mcp enable and /mcp disable in a session; gemini mcp remove in the shell |
Sources: Gemini custom apps help, Gemini tasks help, Gemini CLI MCP servers, Gemini CLI policy engine, Gemini CLI for enterprise, Gemini CLI configuration. Checked November 14, 2026.
Which properties Gemini can reach
Gemini has no saved site to start from. The tool definition for listSites says no site is auto-selected, so every other tool needs the property address, written out in the prompt or taken from the list.
- Ask Gemini to list your Search Console properties with google_search_console__listSites, which also shows the permission level on each.
- Name the property you want next, for example a Domain property such as sc-domain:example.com, or a URL-prefix property written with its protocol and a trailing slash.
- If one workspace holds several Google logins, say which property you mean in the prompt. Tools also accept an optional connection_id, and the starred login is the primary one.
Google's Domain property covers all subdomains and protocols, while a URL-prefix property covers only URLs under that exact prefix, so the two can give different totals for the same site. Several Google logins can sit in one workspace through Add one more account in Ryze AI, each with its own Site. Separate clients belong in separate workspaces.
Search Console access and scopes
Two sign-ins are involved, and each one limits what Gemini can reach.
- Which Google login
- The login you approve at the Connect step in Ryze AI. It sees the properties that login can open, and the Site you save is the one the workspace uses.
- What the login can do
- Read Search Console data and manage sitemaps. The scope is webmasters, which Google lists as read and write access.
- Which Gemini surface
- The Gemini web app is limited to personal Google Accounts in the US, in English. Gemini CLI signs in through a browser, or with an API key sent as a header.
Ryze AI asks for the Search Console scope (webmasters). Keep every requested permission checked on the Google screen, or the connection will not work.
What the Google sign-in grants, and what it leaves out
Ryze AI reaches Search Console as your Google user, through the consent you give on Google's screen. The scope decides which calls can work, and your permission level on the property decides what Search Console allows for that user.
| Scope or level | How Google describes it | What it means for Gemini |
|---|---|---|
| webmasters | Read/write access. | Covers the 5 read tools and the 2 sitemap tools. Google lists sitemaps.submit and sitemaps.delete with this scope only |
| Owner | Has full control over properties in Search Console. | The strongest level. Only owners can set up a bulk data export to BigQuery |
| Full user | Has view rights to all data and can take some actions. | Google's permissions table lists Submit sitemap for owners and full users |
| Restricted user | Has simple view rights on most data. | Performance data is open to restricted users; URL Inspection is listed as Fetch only. Whether submitSitemap works for this level was not tested |
| Associate | Can take certain actions on behalf of your site, or access certain data. | Associates cannot open or view the Search Console account or its data directly, so this is not the level to connect with |
Not requested: webmasters.readonly, the read-only Search Console scope. That means the connection can write sitemaps. The connector has no tool to request indexing, remove URLs from Google, verify a property or add or delete a site, so none of those can happen through Gemini.
The second sign-in, from Gemini to Ryze AI, is a separate OAuth flow on the connector. It chooses which Ryze AI workspaces Gemini may use. One Claude or ChatGPT connection can cover up to 20 workspaces, and the Gemini limit was not checked.
Sources: Search Console API authorization, sitemaps.submit, Search Console permissions. Checked November 14, 2026.
Removing access
To remove access, disconnect Google Search Console on its card in Ryze AI Integrations. In the Gemini app, under Settings, Connected Apps, Custom apps, switch Ryze AI off, or open More details and pick Disconnect (it stays listed, with its permissions revoked) or Remove app. Your Google Account's Linked apps page can unlink it too. In Gemini CLI run gemini mcp remove ryze.
What Gemini can do in Google Search Console
The Ryze AI connector exposes 7 Google Search Console tools: 5 read tools, 1 write tool and 1 delete tool.
| Tool | Type | What it does |
|---|---|---|
| google_search_console__listSites | Read | Lists every Search Console property the connected login can access, with permission levels. |
| google_search_console__runRawSearchAnalytics | Read | Runs a Search Analytics query by query, page, country, device, search appearance or date, for web, image, video, news or Discover results, up to 25,000 rows per request. |
| google_search_console__inspectUrl | Read | Inspects one URL's index status: coverage, verdict, last crawl, canonical, indexing state, mobile usability and rich results. |
| google_search_console__listSitemaps | Read | Lists the sitemaps Search Console knows for a property, with last submitted and downloaded dates, errors, warnings and submitted counts. |
| google_search_console__getIndexationSummary | Read | Returns a sitemap summary for a property: number of sitemaps, submitted URLs, errors, warnings and pending items. |
| google_search_console__submitSitemap | Write | Submits or resubmits a sitemap to Search Console for a property. |
| google_search_console__deleteSitemap | Delete | Removes a sitemap from Search Console for a property. The sitemap file on the site is not touched. |
Five tools only read. submitSitemap and deleteSitemap change Search Console. Google's help page says Gemini requires manual confirmation for any write actions, and whether it counts these two tools as write actions was not checked. In Gemini CLI the default asks before each tool call, and setting trust to true (or passing --trust) skips every confirmation for the server, so leave it off. In the Ryze AI chat the Tool approvals setting starts on Skip all approvals and can be switched to Approve write & delete or Manual approve.
Limits in numbers
| Limit | Number | Source |
|---|---|---|
| Search Analytics requests | 1,200 per minute per site and 1,200 per minute per user. A project gets 40,000 per minute and 30,000,000 per day | Usage limits |
| Search Analytics load | Measured in 10 minute and 1 day chunks. Grouping by page and query together costs the most, and the load grows with the date range. After a quota error Google says to wait 15 minutes | Usage limits |
| URL Inspection requests | 2,000 per day and 600 per minute per site | Usage limits |
| Sites and sitemaps requests | 20 per second and 200 per minute per user | Usage limits |
| Rows in one request | 1 to 25,000, with 1,000 as the default. Ask again with startRow raised by 25,000 until a response has 0 rows | searchanalytics.query reference |
| Rows per day | Google says the method exposes a maximum of 50K rows of data per day per search type, sorted by clicks | Get all your data |
| How fresh the numbers are | Typically available after 2 to 3 days. dataState all adds fresh data that may be incomplete; final or no value returns only finalized data | Get all your data |
| History | Search Console keeps data for the last 16 months | Google Analytics help on Search Console data |
| Time zone | Dates are YYYY-MM-DD in Pacific time | searchanalytics.query reference |
| URL Inspection scope | One URL per call, and only the version in the Google index. A live URL cannot be tested | URL Inspection reference |
| Sitemap counts | Google marks the indexed count in a sitemap listing as deprecated, so rely on submitted counts, errors and warnings | Sitemaps reference |
| Gemini CLI wait per request | 600,000 ms (10 minutes) by default, set per server with timeout | Gemini CLI MCP servers |
Google's pages in the Source column were checked November 14, 2026.
Tested calls through the connector
These 5 Search Console calls went through the Ryze AI connector on November 14, 2026, sent from Claude Code over the default Google sign-in to a Domain property. Gemini talks to the same server, but none of them came from Gemini. Two returned data and 3 were built to be refused or empty so that the exact answers could be recorded. Only field names and outcomes appear here.
| What was asked | Tool | What came back |
|---|---|---|
| The properties the login can reach | listSites | Worked |
| 7 days by query with an equals filter on a random 20-letter string | runRawSearchAnalytics | Worked and returned an empty answer: the whole response was responseAggregationType byProperty, with no rows key |
| 90 days by query, 120 rows, dataState all, an includingRegex filter on query | runRawSearchAnalytics | Worked. Rows came back with keys, clicks, impressions, ctr and position, ordered by clicks, highest first. Fewer rows than the limit came back, so no second page was needed |
| 7 days by query with a row limit of 25,001 | runRawSearchAnalytics | Refused with HTTP 400 |
| A dimension named keyword | runRawSearchAnalytics | Refused with HTTP 400 INVALID_ARGUMENT |
| An end date before the start date | runRawSearchAnalytics | Refused with HTTP 400 |
First 3 prompts to run
Each prompt below says what it asks for. Answers come from your own property, so this page shows no sample numbers.
1. Find the right property
@Ryze AI List every Search Console property my login can access, with the permission level on each.
Tools used: google_search_console__listSites
What comes back: The properties your Google login can open, with a permission level for each. Use one of these addresses as the site in your next prompt.
2. Queries with their clicks and position
@Ryze AI For my Domain property, show the top 50 queries by clicks over the last 90 days, with impressions, CTR and average position.
Tools used: google_search_console__runRawSearchAnalytics
What comes back: Rows grouped by query with clicks, impressions, CTR and position, highest clicks first. Data lags 2 to 3 days behind today.
3. Sitemap health
@Ryze AI List the sitemaps for my property with their last downloaded dates, errors and warnings, then give me the sitemap summary.
Tools used: google_search_console__listSitemaps, google_search_console__getIndexationSummary
What comes back: Each sitemap with its dates, errors, warnings and submitted counts, plus the property summary of sitemaps, submitted URLs, errors, warnings and pending items.
Search Console reports how a site performs in Google results. It has no tool here to ask Google to index a page.
10 jobs to hand to Gemini
Ten things to ask Gemini: nine matched to the Ryze AI tool that answers them, and one the connection cannot do. In the Gemini app, begin the prompt with @ and pick the Ryze AI app. Only listSites and runRawSearchAnalytics were called in the test, from Claude Code, and no job was run from Gemini.
| Job | What to ask Gemini | Tool | Works on the default connection |
|---|---|---|---|
| Find the property address | List every Search Console property I can access, with the permission level on each. | listSites | Yes |
| Top queries | Top queries by clicks and impressions for the last 28 days, with CTR and average position. | runRawSearchAnalytics | Yes |
| Question queries | Only the queries that contain how, what or why, for the last 90 days. | runRawSearchAnalytics | Yes, with a regex or contains filter on query |
| Pages near the click zone | Pages that rank just outside the top results, with the queries they rank for. | runRawSearchAnalytics | Yes, by grouping on page and query |
| Where the clicks come from | Split clicks and impressions by country, device and search appearance, in web and image results. | runRawSearchAnalytics | Yes |
| One article over time | Day by day clicks and impressions for one page since it was published. | runRawSearchAnalytics | Yes, by grouping on date and filtering on page |
| Index status of one URL | Inspect this URL and tell me its coverage, last crawl, canonical and mobile usability. | inspectUrl | Yes, one URL per call |
| Sitemap health | List my sitemaps with errors and warnings, and give the property summary. | listSitemaps, getIndexationSummary | Yes |
| Resubmit or remove a sitemap | Resubmit this sitemap, or remove the old duplicate one from Search Console. | submitSitemap, deleteSitemap | Yes, with the webmasters scope and a permission level that allows it. These change Search Console |
| Request indexing | Ask Google to index this new page. | None | No. No tool requests indexing, removes URLs or verifies a property |
5 ways to connect Gemini to Google Search Console
Custom apps in Gemini accept a server address only, while Gemini CLI can also start a program on your computer. On the pages as read on November 14, 2026, five routes reach Search Console data and fit one of those surfaces or name Gemini. The Ryze AI connector is the main way: Google is approved once, one address serves web, phone and terminal, and no program runs on your machine.
| Way | Gemini surface | Setup in Gemini | What it reaches in Search Console | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Web app, mobile app once added on the web, and Gemini CLI | A custom app with https://connector.get-ryze.ai/mcp under Settings, Connected Apps, or gemini mcp add --transport http with the same address. Sign-in in the browser | 7 tools: Search Analytics, URL inspection of one URL, sitemap lists and summary, submit and remove a sitemap, and the property list | SEO Starter $129 per month with a 3-day free trial, or Paid Ads $89 per month with a 7-day trial. The connector is free |
| Windsor.ai | Gemini is on its list. The page describes a Gemini Enterprise data store connector in public preview and gives no setup for the Gemini app | Connect Search Console once in Windsor.ai, then follow its Gemini guide, which this page did not open | Read-only. Clicks, impressions, CTR and position, with no URL inspection. Web, image, video and news types; no Discover or Google News data | Forever Free (1 data source) after a 30-day trial. Basic $23 per month, or $19 billed annually |
| Coupler.io | Gemini is one of its listed clients, surface not named | Build a Search Console data flow, add Custom MCP as its destination, then paste the server URL and a Bearer token into the client. Of Gemini surfaces only Gemini CLI documents a header | Read-only answers from synced data, refreshed on a schedule down to every 15 minutes. No sitemap management or URL submission | Free plan with manual refresh. Starter $32 per month, or $24 billed annually |
| mcp-gsc (open source, package mcp-search-console 0.4.2) | Gemini CLI is among the clients its README names. The Gemini app takes no local command | Runs on your computer, started by the assistant as a command. You create your own Google OAuth client (Desktop app type) or use a service account key, and add a command entry to the client's MCP config | 20 tools per the README. Reads Search Analytics, sites, sitemaps and URL inspection, with batches of up to 10 URLs. Adding or deleting a site and deleting a sitemap are off by default | Free under the MIT license |
| BigQuery export and Google's BigQuery MCP server | Google's client guidance names Gemini CLI. The Gemini app is not named | Turn on bulk data export in Search Console, then connect the BigQuery MCP server at bigquery.googleapis.com/mcp with Google Cloud credentials. Google does not describe the pair as one route and this page did not test it | Performance data only, from the day the export starts, without anonymized queries. No URL inspection or sitemap actions. Query results capped at 3,000 rows | Google Cloud storage and query costs, with a free usage level |
Options that do not fit Gemini
- A Google Search Console MCP server from Google. Google's list of products with a remote MCP server (stamped November 12, 2026) has no Search Console row, its MCP repository has no Search Console entry, and the Search Console API pages mention no MCP endpoint. Windsor.ai makes the same statement on its own page.
- A built-in Search Console app in Gemini. The general Connected Apps help page does not mention Search Console. This page did not open the app list inside Gemini, so it makes no claim about what that list shows.
- Composio. 14 Search Console tools that read and write, hosted at connect.composio.dev/mcp, with setup pages for ChatGPT, Claude Code, Cursor and others. Gemini is not among the assistants it names.
- Zapier MCP. No Search Console page was found: the addresses zapier.com/mcp/google-search-console and zapier.com/apps/google-search-console/integrations returned HTTP 404 on November 14, 2026.
- ahonn/mcp-server-gsc. One tool, search_analytics, with a row limit of up to 25,000. Its README shows a Claude Desktop configuration and needs service account credentials.
- Developer Knowledge MCP server (Google). Searches and reads Google's developer documentation, including developers.google.com, with no access to your Search Console account.
- AI-powered configuration inside Search Console. An experimental feature that turns a plain description into Performance report filters. It covers only the Search results Performance report, allows 20 requests per user per day and was visible to a small percentage of users. It is not a connector for an outside assistant.
- Google's Analytics MCP server. Open source and read-only for Google Analytics. Its README does not mention Search Console.
Which one to pick
Ryze AI is the best way to connect Gemini to Google Search Console when you want queries, index checks and sitemap actions in the Gemini web app without hosting anything, with one caveat: it needs a Ryze AI plan or trial, it reads and writes sitemaps, and custom apps are open only to US adults on personal Google Accounts, in English. For Gemini CLI on your own machine, the open-source mcp-gsc costs nothing and keeps your data local, but you create the Google OAuth client yourself. Windsor.ai and Coupler.io suit teams that already move marketing data into one account. The BigQuery route suits people who want daily exported tables and are fine with Google Cloud billing.
Sources: Google remote MCP server list, Google MCP repository, Search Console API, Gemini Connected Apps help, Windsor.ai Search Console MCP, Windsor.ai pricing, Coupler.io Search Console MCP, Coupler.io pricing, mcp-gsc on GitHub, mcp-search-console on PyPI, mcp-server-gsc, Composio Search Console toolkit, Zapier MCP quickstart, bulk data export help, BigQuery MCP server, Developer Knowledge MCP, AI-powered configuration, Google Analytics MCP README, Ryze AI Google Search Console guide. Checked November 14, 2026.
Search Console, Gemini and MCP: dates that matter
| Date | What happened |
|---|---|
| January 31, 2022 | The URL Inspection API launched, with 2,000 queries per day and 600 per minute per property. |
| February 21, 2023 | Google announced bulk data export of Search Console performance data to BigQuery. |
| April 9, 2025 | The Search Analytics API gained hourly data for up to 10 days. The Ryze AI tool definition lists dataState final and all and does not list an hour dimension. |
| June 25, 2025 | Google introduced Gemini CLI, with MCP support built in from the start. |
| August 12, 2025 | Gemini CLI v0.1.19 brought the gemini mcp add, remove and list commands. |
| December 4, 2025 | Google announced AI-powered configuration for the Performance report as an experimental feature. |
| December 10, 2025 | The remote BigQuery MCP server arrived in Preview. This is also the earliest entry in the Google Cloud MCP servers release notes, which have no Search Console entry. |
| April 20, 2026 | Google marked the BigQuery MCP server generally available. |
| June 18, 2026 | Gemini CLI stopped serving Google AI Pro and Ultra subscribers and free Code Assist for individuals users. |
| June 30, 2026 | Google wrote that custom MCP support was rolling out in Gemini Spark, now called tasks: the earliest dated Google mention of custom apps found. |
| November 6, 2026 | mcp-search-console 0.4.2 reached PyPI, the newest release on November 14, 2026. |
| November 12, 2026 | Google's list of products with a remote MCP server carried this stamp and had no Search Console row. The same check on November 14 found no Search Console MCP server on Google's pages. |
Sources: URL Inspection API launch, bulk data export, hourly data, AI-powered configuration, BigQuery release notes, Google Cloud MCP release notes, remote MCP server list, mcp-search-console on PyPI, Gemini CLI announcement, Gemini CLI v0.1.19, Gemini CLI to Antigravity CLI, Gemini app update, June 2026. Checked November 14, 2026.
How this guide was tested
One check stands behind this page, run outside Gemini: Search Console calls through the Ryze AI connector on November 14, 2026, sent from Claude Code.
| What was run | What came back |
|---|---|
| Search Console tool list, from Claude Code (November 14) | All 7 tool names resolved from the connector's tool list, with 5 read, 1 write and 1 delete. |
| One property list call (November 14) | listSites worked. |
| Two Search Analytics reads (November 14) | One with an equals filter returned an empty answer. One over 90 days with a regex filter and dataState all returned rows with keys, clicks, impressions, ctr and position. |
| Three requests built to fail (November 14) | A row limit of 25,001, a dimension named keyword and an end date before the start date were each refused with HTTP 400. The messages are in the errors table below. |
Not run: anything inside Gemini. No custom app was added, no gemini mcp add command was typed, no sign-in was finished and no tool was called from Gemini, so the Gemini steps follow Google's pages as they read on November 14, 2026. inspectUrl, listSitemaps and getIndexationSummary were not called. submitSitemap and deleteSitemap were not called either, because they change Search Console. Grouping by page, country, device, search appearance or date, the image, video, news and Discover types, a restricted-user login and a quota error were not tried.
Errors and fixes
Exact error messages from the test
Google returned these three messages in the test on November 14, 2026. Each arrived from the connector as Error 400 followed by Google's JSON error body. If Gemini passes one on, the row says why and what to ask next.
| Message | Why it appeared | What to ask Gemini |
|---|---|---|
| '25001' is not a valid row limit value. | The request asked for more than 25,000 rows. The full message also links to Google's older reference path. | Ask for 25,000 rows or fewer, and ask Gemini to page with startRow for more. |
| Invalid value at 'dimension[0]' (type.googleapis.com/google.searchconsole.v1.searchanalytics.ApiDimension), "keyword" | The dimension name does not exist. Search terms are the dimension query. | Use query, page, country, device, searchAppearance or date. |
| Invalid date range defined by startDate and endDate. End date cannot precede the start date. | The end date was earlier than the start date. | Swap the dates; both are written YYYY-MM-DD. |
Two more answers are documented and were not triggered in the test: a quota exceeded error, where Google says to wait 15 minutes, and a request timed out answer, which the Ryze AI tool definition says to resend once on its own and then narrow with a shorter date range, one dimension and no regex filter.
Sources: Search Console API usage limits and searchanalytics.query reference. Checked November 14, 2026.
Other problems
- Connected Apps is missing in Gemini
- Click Personal Intelligence, then Connected Apps. If it is still missing, check Google's requirements: age 18 or over, US, a personal Google Account and Keep Activity on. Custom apps can only be added in the web app.
- Gemini says the app is unavailable
- Google's help page says the feature is unavailable when Keep Activity is off. Turn it on and try again.
- The card shows Require setup
- No Site is saved for the workspace. Open the Google Search Console card in Ryze AI, check the Site and click Save.
- The Search Console tools do not load in Gemini
- If the connector was added before Search Console was connected, the Ryze AI help center says to remove and re-add it and start a new chat, which it states for Claude and ChatGPT. This has not been tested in Gemini. In Gemini CLI, /mcp reload asks the server for its tools again.
- The tools complain about permissions
- Google says you need appropriate access (owner, full or read) to any Search Console account you reach through the API. Ask Gemini to run listSites to see which properties and permission levels the connected login has. This exact message was not triggered in the test.
- The answer has no rows
- An empty answer is a valid result: with an equals filter on a random string the test got only responseAggregationType byProperty. Check the date range, the filter and the property address, and keep in mind that data lags 2 to 3 days.
- Numbers differ from the Search Console screen
- Check the property type, since a URL-prefix property excludes traffic outside its prefix, and check dataState. Anonymized queries are left out of query data.
- Gemini CLI shows no Ryze AI tools and no error
- Google's page says connection errors at startup are quiet. Run /mcp list, or gemini mcp list in the shell, to see the detail.
- Gemini CLI cannot sign in
- OAuth needs a local browser and a localhost callback. In a headless, SSH or container session use a Ryze AI API key header, or run /mcp auth ryze on a machine with a browser.
- Gemini CLI says it no longer serves your plan
- Since June 18, 2026 Google no longer serves Google AI Pro and Ultra users or free Gemini Code Assist for individuals users in Gemini CLI. Google points them to Antigravity CLI.
- Gemini says a subscription is required
- The Search Console tools need an active Ryze AI plan or free trial. Start the trial in Ryze AI and retry.
Terms on this page
- Custom app
- Google's name for an MCP server linked to the Gemini app by its URL. Google also calls it a custom connected app.
- MCP
- The Model Context Protocol. Gemini uses it to call tools that a server such as the Ryze AI connector offers.
- Domain property
- A Search Console property that aggregates data for all subdomains, protocols and subpaths. In the API its address is written sc-domain:example.com, and verifying it needs a DNS record.
- URL-prefix property
- A property that includes only URLs with the specified prefix, including the protocol. In the API it must end with a trailing slash.
- Average position
- Google defines it as the average position of the topmost result from your site.
- Anonymized queries
- Queries Google omits from reports to protect user privacy. They are left out of bulk data export as well.
- dataState
- A Search Analytics setting. With all, the data includes fresh rows that may be incomplete; with final or no value, only finalized data comes back.
Sources: Gemini custom apps help, Search Console property types, Performance report terms, anonymized queries, searchanalytics.query. Checked November 14, 2026.
Frequently asked questions
How do I connect Gemini to Google Search Console?
Connect Google Search Console in a Ryze AI workspace: open Integrations, click Connect on the Google Search Console card, sign in to Google and save the Site. Then in gemini.google.com open Settings, Connected Apps, Add a custom app, enter https://connector.get-ryze.ai/mcp, click Next, allow the workspace and type @ to pick Ryze AI in a prompt.
Is there a Google Search Console MCP server from Google?
None was found on November 14, 2026. Google's list of products with a remote MCP server, its MCP repository and the Search Console API pages contain no Search Console server. Google does document two other routes to the data: the Search Console API and bulk data export to BigQuery.
Does Gemini have a built-in Search Console connector?
Google's general Connected Apps help page does not mention Search Console, and this page did not open the app list inside Gemini, so it cannot say what that list shows. The Ryze AI connector gives Gemini a hosted URL that you add as a custom app.
What is the Google Search Console MCP URL for Gemini?
For the Ryze AI connector it is https://connector.get-ryze.ai/mcp, the same address for every user, entered as a custom app in the Gemini web app or with gemini mcp add in Gemini CLI. Community servers such as mcp-gsc have no fixed URL: they run as a local command on your computer.
Which Gemini plan do I need?
Google's help page for custom apps names no plan. It requires you to be 18 or over and in the US, signed in with a personal Google Account (not a work or school account), with Keep Activity on. It is English only.
Can Gemini change anything in my Search Console?
Only sitemaps. submitSitemap submits or resubmits a sitemap and deleteSitemap removes one from Search Console; the file on your site is not touched. The other 5 tools read. No tool requests indexing, removes URLs from Google, verifies a property or adds or deletes a site.
Can Gemini ask Google to index a new page?
No. The connector has no tool that requests indexing. inspectUrl reports the index status of one URL, and submitSitemap sends a sitemap, which is a different action.
What Search Console access does the Google login need?
A login with access to a verified property. Google's permissions table lists Submit sitemap for owners and full users, and lists restricted users as able to view performance data. Keep every requested permission checked on the Google screen, then check the Site in Ryze AI.
How many rows can Gemini get back in one query?
Up to 25,000 per request. A row limit of 25,001 was refused with HTTP 400 in the November 14, 2026 test. For more rows, the request is repeated with startRow raised by 25,000 until a response has no rows, and Google exposes at most 50K rows per day per search type.
How recent is the data Gemini sees?
Google says data is typically available after 2 to 3 days, and Search Console keeps the last 16 months. With dataState all the answer can include fresh rows that may be incomplete.
Does this work in Gemini CLI?
Yes. Run gemini mcp add --transport http -s user ryze https://connector.get-ryze.ai/mcp, then start Gemini CLI and sign in, or run /mcp auth ryze. Since June 18, 2026 Gemini CLI no longer serves Google AI Pro and Ultra users or free Code Assist for individuals users.
Does it work in the Gemini mobile app?
Custom apps can only be added in the Gemini web app. Once connected on the web, Google says the app also works in the Gemini mobile app.
Can I connect more than one Search Console account?
Yes. Several Google logins can be connected to one workspace with Add one more account, each with its own Site, and one is the primary the agent uses by default. Tools accept an optional connection_id. Separate clients belong in separate workspaces.
How much does it cost to connect Gemini to Google Search Console?
Connecting is free, but the tools need an active Ryze AI plan or trial. SEO Starter is $129 per month with a 3-day free trial, Paid Ads is $89 per month with a 7-day free trial, and Agency is $279 per month. Annual billing takes 30% off the first year.
How do I disconnect Search Console from Gemini?
Remove the Ryze AI app in Gemini under Settings, Connected Apps. To cut off Search Console itself, disconnect it in Ryze AI Integrations, or revoke access on your Google Account permissions page.