CircleCI · Claude Code
Add the CircleCI MCP server to Claude Code
Inspect CircleCI projects, pipelines, workflows, jobs, logs, tests and artifacts, and debug failed builds.
1. Add the server
Run in your terminal
claude mcp add --transport http circleci https://mcp.circleci.com/v1/mcp
Scopes, env vars, OAuth and limits: Claude Code MCP config guide
2. Sign in
Run /mcp inside Claude Code to sign in to remote servers that use OAuth. CircleCI is hosted by CircleCI, so there is nothing to install or keep updated.
3. Try it
Ask Claude Code 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.
- · Add --scope project to share a server with your team through .mcp.json in the repo.
- · Use claude mcp list to see what is connected and claude mcp remove <name> to drop one.
FAQ
- How do I add the CircleCI MCP server to Claude Code?
- Run: claude mcp add --transport http circleci https://mcp.circleci.com/v1/mcp. Run /mcp inside Claude Code to sign in to remote servers that use OAuth.
- 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 Claude Code uses them; check CircleCI's docs for any plan or permission requirements.
Links
CircleCI in other clients
More developer tools for Claude Code
Built an MCP server? Get it listed everywhere →
Shipping an Android app? Google Play needs 12 testers for 14 days first. Get them with Tester Exchange →
Reviewed Oct 21, 2026. Command generated from the registry record and checked against Claude Code's documented syntax.