CircleCI · Cursor
Add the CircleCI MCP server to Cursor
Inspect CircleCI projects, pipelines, workflows, jobs, logs, tests and artifacts, and debug failed builds.
1. Add the server
Paste into .cursor/mcp.json (project) or ~/.cursor/mcp.json (global)
{
"mcpServers": {
"circleci": {
"url": "https://mcp.circleci.com/v1/mcp"
}
}
}Scopes, env vars, OAuth and limits: Cursor MCP config guide
2. Sign in
Cursor prompts you to sign in the first time a remote OAuth server is used. CircleCI is hosted by CircleCI, so there is nothing to install or keep updated.
3. Try it
Ask Cursor 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.
- · Remote servers take a url; local servers take command and args.
- · Values can reference ${env:NAME} so secrets stay out of the file.
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 Cursor?
- Run: { …. Cursor prompts you to sign in the first time a remote OAuth server is used.
- 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 Cursor uses them; check CircleCI's docs for any plan or permission requirements.
Links
CircleCI in other clients
More developer tools for Cursor
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 Cursor's documented syntax.