Circleci MCP Server
CircleCI pipeline management and diagnostic tools for AI-powered IDEs.
Data last scanned today · Reviewed today
Overview
This repository provides an MCP server designed to bridge CircleCI with AI-compatible environments. It allows developers to query pipeline status, retrieve build logs, and analyze test results directly through natural language requests within their development workflow. Additional utilities include identifying underused resource classes and detecting flaky tests via historical data analysis. Note that this specific repository is now deprecated, as the functionality has been integrated directly into the official CircleCI CLI. Users are encouraged to migrate to the CLI tool for future updates and support.
Our verdict
With a security score of 58/100, this server is currently classified as high risk. The repository lacks a read-only mode, meaning every installation provides full write access, and it lacks OAuth support for managing user credentials. Given its status as deprecated and the availability of superior, native integrations via the CircleCI CLI, users should avoid this repository in favor of the official maintained CLI solution.
- Maintained by the official CircleCI organization
- Provides diverse tools for build failure and test analysis
- Small footprint with only 8 direct dependencies
- Active development evidenced by recent commits
- Officially deprecated in favor of the CircleCI CLI
- High security risk due to lack of read-only mode
- Does not support OAuth for secure authentication
- License status listed as NOASSERTION
Setup
{
"mcpServers": {
"mcp-server-circleci": {
"args": [
"-y",
"@circleci/mcp-server-circleci"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| config_helper | Validate and get guidance for your CircleCI configuration | low |
| download_usage_api_data | Download usage data from the CircleCI Usage API | low |
| find_flaky_tests | Identify flaky tests by analyzing test execution history | low |
| find_underused_resource_classes | Find jobs with underused compute resources | low |
| get_build_failure_logs | Retrieve detailed failure logs from CircleCI builds | low |
| get_job_test_results | Retrieve test metadata and results for CircleCI jobs | low |
| get_latest_pipeline_status | Get the status of the latest pipeline for a branch | low |
| list_artifacts | List artifacts produced by a CircleCI job | low |
| list_component_versions | List all versions for a CircleCI component | low |
| list_followed_projects | List all CircleCI projects you're following | low |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf | ||||
| ChatGPT |
Frequently asked questions
›Is this project still actively maintained?
No, this repository is deprecated. The CircleCI MCP server functionality is now built directly into the CircleCI CLI.
›What is the recommended way to use CircleCI with MCP now?
You should visit cli.circleci.com to get started with the latest version integrated into the CircleCI CLI.
›Do I need a CircleCI API token to use this server?
Yes, a CircleCI Personal API token is required to authenticate with the service.
›Are there optional configuration settings for the server?
Yes, you can configure the CIRCLECI_BASE_URL for on-premise customers and adjust the MAX_MCP_OUTPUT_LENGTH to control the maximum response length.
Badge
Maintain this server? Add the live badge to your README.