CircleCI/mcp-server-circleci

Overview

This MCP server provides a bridge between CircleCI and the Model Context Protocol, allowing AI tools to query and control CircleCI pipelines. It exposes CircleCI resources such as pipelines, jobs, and workflows through the standard MCP interface. The implementation is written in TypeScript and designed for integration with MCP-compatible clients.

Best for

Best for
Developers using CircleCI who want to control CI/CD workflows through natural language interfaces or AI assistants

Use cases

• Monitor pipeline status and job logs from an AI coding assistant
• Trigger new builds or rerun failed jobs directly via natural language commands
• Retrieve build artifacts and environment variables for debugging

How to use

Install

npx -y @smithery/cli install @CircleCI-Public/mcp-server-circleci --client claude

Tools exposed

• REQUIRE_REQUEST_TOKEN
• CIRCLECI_TOKEN
• CIRCLECI_BASE_URL
• MCP_ALLOWED_HOSTS
• MCP_ALLOWED_ORIGINS
• MCP_BIND_HOST

Tested with

Claude Desktop, Claude Code, Cursor, Windsurf, Continue, VS Code

Example client config

{\n  "mcpServers": {\n    "circleci-mcp-server": {\n      "command": "npx",\n      "args": ["-y", "@circleci/mcp-server-circleci@latest"],\n      "env": {\n        "CIRCLECI_TOKEN": "your-circleci-token",\n        "CIRCLECI_BASE_URL": "https://circleci.com",\n        "MAX_MCP_OUTPUT_LENGTH": "50000"\n      }\n    }\n  }\n}

Notes

This MCP server provides a bridge between CircleCI and the Model Context Protocol, allowing AI tools to query and control CircleCI pipelines. It exposes CircleCI resources such as pipelines, jobs, and workflows through the standard MCP interface. The implementation is written in TypeScript and designed for integration with MCP-compatible clients.

84 stars on GitHub. Last updated 2026-05-18.

Use cases

• Monitor pipeline status and job logs from an AI coding assistant
• Trigger new builds or rerun failed jobs directly via natural language commands
• Retrieve build artifacts and environment variables for debugging

Pros

• Follows the MCP standard, enabling easy integration with multiple AI clients
• Written in TypeScript, making it accessible to a large developer community
• Open source with a clear, focused scope tied to CircleCI

Cons

• Limited to CircleCI users; no support for other CI platforms
• Relatively new project with only 84 stars and likely limited community support
• Requires an MCP-compatible client and a running MCP host infrastructure

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.