Use SEOmatic in Gemini

Connect Gemini#

1. 1Gemini web app: add a custom app. At gemini.google.com, open Settings, then Connected Apps. Under Custom apps, choose Add a custom app and enter https://app.seomatic.ai/api/mcp.
2. 2Gemini web app: approve access. Click Next, sign in to SEOmatic and approve access. In a chat, type @ and pick SEOmatic so Gemini uses it.
3. 3Gemini CLI: install the extension. On a Workspace account or with a Gemini API key, run this in your shell (not inside gemini): gemini extensions install https://github.com/Minh42/seomatic-mcp
4. 4Gemini CLI: sign in. Start gemini and ask a question about your site. Sign in or create a free SEOmatic account in the browser window that opens, then pick your site. If no window opens, run /mcp auth seomatic.
5. 5Ask your first question. Try “How did my site do on Google in the last 28 days?” and check the answer cites your real Search Console numbers.

# Gemini web app (gemini.google.com, US personal accounts):
Settings -> Connected Apps -> Custom apps -> Add a custom app
URL: https://app.seomatic.ai/api/mcp
Next -> sign in to SEOmatic and pick your site

# Gemini CLI (Workspace accounts or a Gemini API key), in your shell:
gemini extensions install https://github.com/Minh42/seomatic-mcp
# start gemini and ask a question; sign in when the browser opens
# (or run /mcp auth seomatic inside gemini)

# Gemini CLI, server only, no extension:
gemini mcp add --transport http seomatic https://app.seomatic.ai/api/mcp
# over SSH or in a container, add a key instead of the browser flow:
#   --header "Authorization: Bearer smk_live_..."

# Personal Google account and want a coding agent? Use Antigravity:
#   seomatic.ai/ai-assistants/antigravity

The Gemini App, Gemini CLI or Antigravity?

Chatting at gemini.google.com? Use the custom app, and type @ to pick SEOmatic in a chat. In Gemini CLI on a Workspace account or with an API key? Pick the extension. It registers the same SEOmatic server and adds the SEO skills, so Gemini CLI knows the audit and striking-distance workflows. On a personal account and want a coding agent? Use Antigravity.

Try Asking#

• “Compare my Google clicks for the last 28 days with the 28 days before.”
• “Which of my pages are closest to page 1, and what would move them?”
• “Inspect these ten URLs and tell me which are not indexed and why.”
• “Audit my site and rank the fixes by impact.”
• “Is my business named in Google AI Overviews for my main services?”
• “Find the noindex or canonical problem in this repo that the audit flagged.”

What It Costs#

Connecting is free. Reading your own data never uses credits: Search Console performance and insights, index status, rankings, site audits, AI citations, traffic and your tasks. Only live market lookups (keyword metrics, search results, backlinks), AI visibility scans and the fixes you approve use AI credits; every tool is labelled free or billed. On the Free plan, market lookups count against 5 free questions a month. The workspace Owner sees every credit spent, by feature, in Settings > Usage. Gemini itself is billed by its maker, not by SEOmatic: nothing on our side counts tokens.

Nothing Changes on Your Site Without Your Approval#

Gemini can read and analyze freely. Any change to a live page is staged in SEOmatic, never pushed by Gemini. A staged change is a proposal: it says what will change and why, and nothing touches your site until you approve it. The assistant records your decision, and it is told never to approve anything on its own judgment. Approved fixes start within seconds, the page's previous state is stored, and any applied change can be rolled back. Changes that could take a page out of Google, like a noindex, need an extra explicit confirmation. Code changes Gemini CLI proposes in your repo follow your own review: nothing is committed unless you accept it.

Gemini says SEOmatic is connected but answers without my data.

Start a new chat and check that SEOmatic is enabled for that conversation in the tools menu. This is the step most people miss.

The SEOmatic page says "This connection request expired".

Start the connection again from Gemini, or paste the setup prompt again.

The Authorize page shows the wrong email or no workspace.

Click Switch account on that page and sign in with the SEOmatic account that owns the site.

Why does Gemini say it cannot change my site?

Fixes need a live paid plan or trial. On the Free plan, or when billing is paused or failed, your assistant can read and answer only.

How do I disconnect?

Open Settings > AI Agents, scroll to API Keys and delete the row named OAuth: Gemini. See disconnect an assistant.