AI knowledge base for Gemini CLI.
Plug Perfect Wiki into Gemini CLI, and your terminal agent can look up product specs, metric definitions and team processes in the middle of a task — then write back what it learned.
Connect Gemini CLI in two minutes.
A single gemini mcp add registers the server in your user settings. Authenticate once inside a session, and Gemini CLI can call every Perfect Wiki tool.
- →Streamable HTTP transport — nothing to install locally
- →User scope keeps it available across all your projects
- →Browser sign-in, so no token sits in your settings file
Gemini CLI looks it up — instead of guessing.
When a task depends on how your company does things, Gemini CLI queries Perfect Wiki mid-task, cites the page it relied on, and can record new decisions back into the knowledge base.
- →Answers cite the wiki page they came from
- →Reads the full page when a summary isn’t enough
- →Records new decisions with create_page and update_page
queries/weekly_churn.sql with a comment linking to the definition.How to connect Perfect Wiki to Gemini CLI.
- 1Register the server:
gemini mcp add --transport http --scope user perfect-wiki https://api.perfectwiki.xyz/mcp - 2Start
geminiand run/mcp auth perfect-wiki. - 3Your browser opens Perfect Wiki — sign in, choose the knowledge bases and the access level, then click Allow access.
- 4Run
/mcpto see the Perfect Wiki tools, then ask something like “What does our on-call handbook say about paging?”
More details in the Perfect Wiki MCP server guide and Gemini CLI's MCP documentation.
Generate a token in the Perfect Wiki settings of the knowledge base you want to expose. Each token is scoped to a single knowledge base and has read & write access — sign in with OAuth instead to cover several knowledge bases with one connection.
What your team does with Perfect Wiki in Gemini CLI.
Metric definitions everyone agrees on
Analysts and data engineers get SQL and dashboards built on the definitions in your metrics glossary — not on whatever the model assumes “active” means.
Find your way around a new service
Joining a team or picking up an unfamiliar repo? Gemini CLI reads the architecture and ownership pages and explains the service in context.
Specs next to the implementation
Compare what the product spec asks for with what the code does, and turn the gaps into a to-do list before release.
Ask a question in plain language and get an AI answer from your SOPs and FAQs, with the source pages.
See which knowledge bases the connection covers and the access level for each.
List every page in a knowledge base.
Read the full content of a specific page.
Create a new page — draft SOPs straight from chat.
Update an existing page, so SOPs never go stale.
Remove pages that are no longer needed.
Get the name and access level of one knowledge base.
Start from a ready-made SOP. Keep it alive here.
Download any of our 294 standard operating procedure templates in Word, PDF, Excel or CSV, no sign-up needed. Then put it in Perfect Wiki so your team can find it and ask about it.
Browse all 294 SOP templates →Frequently asked questions
Add the server with gemini mcp add, start a Gemini CLI session and run /mcp auth perfect-wiki. Finish the sign-in in your browser, choose the knowledge bases and the access level, and allow access.
With --scope user the entry is written to ~/.gemini/settings.json under mcpServers, so it is available in every project. You can edit that file directly too — for a legacy API token, add a headers entry with your Authorization header.
Since June 2026, Gemini CLI serves Gemini Code Assist Standard and Enterprise licences and paid Gemini API keys. Free and Google AI Pro/Ultra consumer users have moved to Antigravity CLI, which is configured differently — see our Google Antigravity guide.
Uploaded files are a snapshot: they go stale the moment a policy changes, and they stay in one chat or project. Through the MCP server, Gemini CLI reads the current version of your SOPs and FAQs from Perfect Wiki every time, links to the source page, and only reaches the knowledge bases you connect.
Only if you allow it. When you sign in with OAuth you choose Read only or Read & write on the consent screen, and writes only work in knowledge bases where you can edit. Legacy API tokens always have full access to their one knowledge base. Most MCP clients also ask for your confirmation before running a tool that writes.
Yes, with a single connection. When you sign in, choose all knowledge bases you can access (including ones you get access to later) or only the ones you select. Gemini CLI can search across all of them at once and has to name the target knowledge base for every change. API tokens cover one knowledge base each, so add one server entry per token.
The Perfect Wiki MCP server only forwards the requests Gemini CLI makes. Tool results — the pages and answers it fetches — are passed to the model as part of the conversation and handled under your AI provider's data policy.
The MCP server is included in every Perfect Wiki plan, and the same API rate limits apply. You can try it with the 14-day free trial — no credit card required.
Didn't find what you're looking for? Contact our support →
Put your SOPs to work in Gemini CLI.
Keep your SOPs, manuals and FAQs in Perfect Wiki — and give your whole team answers right where they work.