Ask Gemini CLI about your reviews.
Add Grades.com to Gemini CLI with an API key and ask about reviews, ratings and replies from your terminal. Gemini CLI asks you before it runs a Grades.com tool.
Available
Gemini CLI today; the Gemini app on the web and Gemini in Google Workspace are not supported yet.
Animated example: in a terminal, someone asks Gemini CLI what reviews came in this week; it runs the Grades.com review tools and lists one new 5-star review of a dental practice that still needs a reply.
What you can ask
Which reviews still need a reply?
A list per business, newest first, with the site and the rating.
Draft a reply to the newest 3-star review
A draft in your tone; nothing is posted until you confirm.
How did we do last month?
New reviews, average rating and replies, per site.
What does ChatGPT say about us?
Your AI Reputation: what assistants say, and what changed.
Set it up
Create an API key
In Connect your AI, create a secret key with
reviews:read,reviews:writeandcompanies:readfor all your businesses, and save it in an environment variable such asGRADES_API_KEY.Add the server
Under
mcpServersin~/.gemini/settings.json, add"grades": { "httpUrl": "https://mcp.grades.com/mcp", "headers": { "Authorization": "Bearer $GRADES_API_KEY" } }.Ask
Start
geminiin a folder you trust, type/mcp listand check that grades shows Connected, then ask about your reviews.
Gemini CLI loads MCP servers only in folders you trust. It runs with a Gemini API key, Vertex AI or a Gemini Code Assist Standard or Enterprise license; since June 18, 2026 Google AI Pro, Ultra and free Code Assist sign-ins use Antigravity CLI instead.
What you need
- A Grades.com account (14-day free trial of Pro, no card needed)
- Gemini CLI, signed in with a Gemini API key, Vertex AI or a Gemini Code Assist Standard or Enterprise license
- A secret API key with
reviews:read,reviews:writeandcompanies:readfor all your businesses, from Connect your AI
Every plan from Starter
Your assistant signs in to Grades.com and sees only the businesses you allow. Anything that changes something waits for your Confirm.
See pricing →Frequently asked questions
Does the Gemini app on the web work?
Not yet. Google lets personal accounts in the US add a custom app by its MCP server URL in the Gemini web app (English only, Keep Activity on; not work or school accounts). We have not tested Grades.com there, so we do not offer it yet.
What about Gemini in Gmail, Docs and Sheets?
No. Gemini in Google Workspace connects to the partner apps Google lists; Google does not document adding your own MCP server there.
Can I sign in instead of using a key?
Gemini CLI supports sign-in for MCP servers and Grades.com offers it, but we have not tested that pairing yet. Use an API key for now.
Why does my key need all my businesses?
A key limited to some businesses cannot connect an AI app. Use a key for all your businesses; you can delete it any time in Connect your AI.
Can Gemini post a reply by itself?
No. Gemini CLI asks you before it runs a Grades.com tool, and a reply is drafted first; nothing is saved or posted until you approve it. A key without reviews:write cannot post at all.
Gemini CLI has no Grades.com tools. What now?
Type /mcp list. If grades shows Disabled, start gemini in a folder you trust. If it shows Disconnected, check that the address is exactly https://mcp.grades.com/mcp (a typo there also prints "MCP issues detected") and that GRADES_API_KEY holds a current key: a mistyped, deleted or expired key shows Disconnected too, and Gemini CLI may suggest /mcp auth grades. Create a new key in Connect your AI and update GRADES_API_KEY.
Does it work in Gemini Code Assist or Antigravity?
Not tested yet. Gemini Code Assist agent mode reads the same settings file, and Antigravity uses serverUrl and headers in its own MCP settings.
Gemini is a trademark of Google LLC. Grades.com is not affiliated with or endorsed by Google.
Connect Grades.com to Gemini CLI
14-day free trial of Pro, no card needed.