# Buildkite MCP Server

> Buildkite MCP Server is an open-source MCP server. MCP server exposing Buildkite API data (pipelines, builds, jobs, tests) to AI tooling and editors. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/buildkite/buildkite-mcp-server
- **MCP Registry name:** io.github.buildkite/buildkite-mcp-server
- **Listing updated:** 2026-11-13

## About

MCP server exposing Buildkite API data (pipelines, builds, jobs, tests) to AI tooling and editors.

## Install

### Claude Code (Terminal)

```sh
claude mcp add buildkite-mcp-server --env BUILDKITE_API_TOKEN='<BUILDKITE_API_TOKEN>' -- docker run -i --rm -e BUILDKITE_API_TOKEN ghcr.io/buildkite/buildkite-mcp-server:0.7.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "buildkite-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BUILDKITE_API_TOKEN",
        "ghcr.io/buildkite/buildkite-mcp-server:0.7.0"
      ],
      "env": {
        "BUILDKITE_API_TOKEN": "<BUILDKITE_API_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "buildkite-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BUILDKITE_API_TOKEN",
        "ghcr.io/buildkite/buildkite-mcp-server:0.7.0"
      ],
      "env": {
        "BUILDKITE_API_TOKEN": "<BUILDKITE_API_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "buildkite-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BUILDKITE_API_TOKEN",
        "ghcr.io/buildkite/buildkite-mcp-server:0.7.0"
      ],
      "env": {
        "BUILDKITE_API_TOKEN": "<BUILDKITE_API_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "buildkite-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BUILDKITE_API_TOKEN",
        "ghcr.io/buildkite/buildkite-mcp-server:0.7.0"
      ],
      "env": {
        "BUILDKITE_API_TOKEN": "<BUILDKITE_API_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "buildkite-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BUILDKITE_API_TOKEN",
        "ghcr.io/buildkite/buildkite-mcp-server:0.7.0"
      ],
      "env": {
        "BUILDKITE_API_TOKEN": "<BUILDKITE_API_TOKEN>"
      }
    }
  }
}
```

## FAQ

### Is Buildkite MCP Server free?

Yes. Buildkite MCP Server is open source, so you can use and self-host it for free.

### How do I add Buildkite MCP Server to Claude Code?

Run this command in your terminal: claude mcp add buildkite-mcp-server --env BUILDKITE_API_TOKEN='<BUILDKITE_API_TOKEN>' -- docker run -i --rm -e BUILDKITE_API_TOKEN ghcr.io/buildkite/buildkite-mcp-server:0.7.0

---
Source: https://ai-powered.com/mcp/buildkite-mcp-server
