CircleCI · Gemini CLI
Add the CircleCI MCP server to Gemini CLI
Inspect CircleCI projects, pipelines, workflows, jobs, logs, tests and artifacts, and debug failed builds.
1. Add the server
Run in your terminal
gemini mcp add --transport http circleci https://mcp.circleci.com/v1/mcp
Scopes, env vars, OAuth and limits: Gemini CLI MCP config guide
2. Sign in
Run /mcp auth <name> inside Gemini CLI to sign in to an OAuth server. CircleCI is hosted by CircleCI, so there is nothing to install or keep updated.
3. Try it
Ask Gemini CLI for something CircleCI can do. Inspect CircleCI projects, pipelines, workflows, jobs, logs, tests and artifacts, and debug failed builds. Approve the first tool call and check the result before allowing write actions automatically.
- · In settings.json, streamable HTTP servers use httpUrl, SSE servers use url, local servers use command.
- · includeTools and excludeTools limit which tools the model sees.
Get the weekly agent stack update
New official MCP servers, spec changes and harness releases, checked against the source. One email a week, no fluff.
FAQ
- How do I add the CircleCI MCP server to Gemini CLI?
- Run: gemini mcp add --transport http circleci https://mcp.circleci.com/v1/mcp. Run /mcp auth <name> inside Gemini CLI to sign in to an OAuth server.
- Is this the official CircleCI MCP server?
- Yes. It is published by CircleCI as com.circleci/mcp in the official MCP registry.
- Does the CircleCI MCP server need an API key?
- It is a hosted server. Most hosted servers sign you in with OAuth the first time Gemini CLI uses them; check CircleCI's docs for any plan or permission requirements.
Links
CircleCI in other clients
More developer tools for Gemini CLI
Work at CircleCI?
Feature CircleCI across the directory and its category from $49/month.
Reviewed Oct 5, 2026. Command generated from the registry record and checked against Gemini CLI's documented syntax.