What a Gemini CLI extension is
A Gemini CLI extension is a package that extends the terminal agent — typically bundling an MCP server, context files, and sometimes custom commands into one installable unit. Where a skill teaches the agent a procedure in prose, an extension gives it new tools and data: a bridge to a database, a wrapper around a system utility, a connection to another model surface.
Extensions install from a GitHub repository or a local path through the gemini extensions command family, and they declare themselves through a manifest — gemini-extension.json — which is exactly what makes them reviewable. The manifest says what the extension contributes before you run anything: which MCP servers it launches, which environment variables it wants, which context file it injects.
How to evaluate one before you install it
- Read the manifest first, not the README. The README sells;
gemini-extension.jsontells you what actually loads — server commands, env vars, file paths. An extension asking for credentials it does not obviously need deserves a second look. - Check what the MCP server actually does. Extensions that proxy to a hosted service inherit that service's uptime and privacy posture; ones that launch a local binary inherit its maintenance state. Prefer tools whose server code is in the same repository as the extension.
- Look for the update path. The extension ecosystem is young and the CLI itself moves quickly — a healthy extension documents which CLI version it was built against and how it handles API drift.
- Prefer narrow extensions. A pager that pages and a linter that lints compose; an extension that tries to be a platform is usually worse at each individual job.
Official versus community
Google maintains the CLI itself and a first-party extension gallery linked from the repository — entries sourced from it carry the official badge. Community extensions are the larger half of this page, and they are verified against their manifests and repositories rather than their download counts; a useful extension with ten stars still gets listed, and a popular one with a stale manifest gets flagged.
One boundary worth knowing: extensions and skills solve different layers. An extension hands the agent new capability (tools, data, commands); a skill teaches it a procedure for capabilities it already has. If what you need is "do X better," look at the skills hub — if it is "do X at all," you are in the right place. Everything listed below was checked against its manifest on the date stamped — the CLI moves fast enough that manifest drift is the failure mode to watch.