MCP server
CircleCI MCP Server
- Maintainer
- Official · CircleCI
- Runs
- Remote
- GitHub
- ★ 93, last push 2026-10-21 (checked 2026-10-24)
- URL
- https://mcp.circleci.com/v1/mcp
- Registry
- com.circleci/mcp
- Connects to
- CircleCI
- DevHunt
- CircleCI on DevHunt
Install the CircleCI MCP Server
Pick your client. Remote first: nothing to install, and you sign in with OAuth where the client supports it. Config shapes checked against each client's docs on 2026-10-25.
The URL also takes Authorization as a header (see its docs), for clients without OAuth sign-in.
Run in a terminal, then /mcp inside Claude Code to sign in. Add --scope project to share it via .mcp.json. docs
claude mcp add --transport http circleci https://mcp.circleci.com/v1/mcp
Customize > Connectors > Add > Add custom connector, paste this URL and sign in. It syncs to Claude Desktop and mobile. docs
https://mcp.circleci.com/v1/mcp
The free plan allows one custom connector. On Team and Enterprise an owner adds it under Organization settings > Connectors.
chatgpt.com/plugins > + > Add custom MCP server, paste the URL, set up sign-in and create it as a plugin. Then @-mention it in a chat. docs
https://mcp.circleci.com/v1/mcp
Workspace admins can turn custom MCP plugins off.
Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project), or use the install button. docs
{
"mcpServers": {
"circleci": {
"url": "https://mcp.circleci.com/v1/mcp"
}
}
}Add to .vscode/mcp.json (note the "servers" key and the type), or use the install button. Command Palette > "MCP: Open User Configuration" for all workspaces. docs
{
"servers": {
"circleci": {
"type": "http",
"url": "https://mcp.circleci.com/v1/mcp"
}
}
}Run codex mcp add circleci --url https://mcp.circleci.com/v1/mcp (then codex mcp login circleci), or add this to ~/.codex/config.toml. The CLI, IDE extension and Codex app share it. docs
[mcp_servers.circleci] url = "https://mcp.circleci.com/v1/mcp"
Run in a terminal (-s user adds it for all projects), then /mcp auth to sign in. In ~/.gemini/settings.json the key is httpUrl. docs
gemini mcp add -s user --transport http circleci https://mcp.circleci.com/v1/mcp
Run in a terminal; it writes ~/.copilot/mcp-config.json. docs
copilot mcp add --transport http circleci https://mcp.circleci.com/v1/mcp
Add to mcp_config.json: ~/.config/devin/mcp_config.json on macOS and Linux (older installs: ~/.codeium/windsurf/mcp_config.json), %APPDATA%\devin\ on Windows. docs
{
"mcpServers": {
"circleci": {
"serverUrl": "https://mcp.circleci.com/v1/mcp"
}
}
}Add to Zed's settings.json (or Settings > AI > MCP Servers > Add Server). Remote servers without an Authorization header sign in with OAuth. docs
{
"context_servers": {
"circleci": {
"url": "https://mcp.circleci.com/v1/mcp"
}
}
}Add to opencode.json in the project (or ~/.config/opencode/opencode.json). Sign in with opencode mcp auth circleci. docs
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"circleci": {
"type": "remote",
"url": "https://mcp.circleci.com/v1/mcp",
"enabled": true
}
}
}Add to ~/.kiro/settings/mcp.json (all projects) or .kiro/settings/mcp.json (this project). docs
{
"mcpServers": {
"circleci": {
"url": "https://mcp.circleci.com/v1/mcp"
}
}
}MCP Servers > Configure > Configure MCP Servers opens cline_mcp_settings.json; add this entry. docs
{
"mcpServers": {
"circleci": {
"type": "streamableHttp",
"url": "https://mcp.circleci.com/v1/mcp"
}
}
}Security notes
- The remote server runs at mcp.circleci.com, hosted by CircleCI. You sign in with OAuth in clients that support it, or with Authorization header where OAuth isn't available, and it acts with your account's permissions.
- It acts on real infrastructure with your credentials. Use a read-only role or a sandbox account first.
Alternatives
- Kubesharkofficial · ★ 12k
Live Kubernetes network traffic: HTTP, gRPC, Redis, Kafka and DNS calls between services.
- Cloudflareofficial · ★ 4.4k
A set of hosted servers (docs, Workers bindings, builds, observability, Radar and more), each at its own URL; the docs one is shown.
- Azureofficial · ★ 3.8k
Azure resources, storage, Cosmos DB, Key Vault, monitoring and CLI commands from one server.
- Fly.ioofficial · ★ 1.7k
MCP server built into flyctl to manage Fly apps, machines, volumes and logs.
- Terraformofficial · ★ 1.6k
Look up Terraform providers, modules and policies in the registry, and manage HCP Terraform workspaces.
- Google Cloud Runofficial · ★ 632
Deploy code or containers to Cloud Run and list services and logs.
- Argo CDofficial · ★ 596
List, sync and inspect Argo CD applications and their resources.
- Renderofficial · ★ 180
Create services and databases on Render, check deploys, logs and metrics.
FAQ
What does the CircleCI MCP Server do?+
Find why a build failed, spot flaky tests and rerun pipelines.
Is the CircleCI MCP server official?+
Official: built and maintained by CircleCI.
How do I add CircleCI to Claude Code?+
Run: claude mcp add --transport http circleci https://mcp.circleci.com/v1/mcp, then /mcp inside Claude Code to sign in. Add --scope project to share it with your team through .mcp.json.
How do I use the CircleCI MCP server in Cursor or VS Code?+
Open the Cursor or VS Code tab above: it has the mcp.json entry and a one-click install link. Cursor uses the "mcpServers" key; VS Code uses "servers" and needs a type ("http").
Does CircleCI work in ChatGPT and claude.ai?+
Yes, it has a remote URL (https://mcp.circleci.com/v1/mcp). In claude.ai add it under Customize > Connectors > Add custom connector; in ChatGPT under chatgpt.com/plugins > Add custom MCP server.
What are the alternatives to the CircleCI MCP server?+
Other cloud & devops MCP servers: Kubeshark, Cloudflare, Azure, Fly.io and Terraform.