# GitHub CI/CD MCP Server

> GitHub CI/CD MCP Server is an open-source MCP server for developer tools. GitHub repo, pull request, Actions and deployment tools for CI/CD agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/devstephenke-sys/github-free-mcps
- **MCP Registry name:** io.github.devstephenke-sys/github-cicd
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Built on both the GitHub REST and GraphQL APIs, this stdio server groups its tools by task: repositories and branches, commits and CI status, pull requests and reviews, issues, releases and tags, branch protection, Actions workflows, deployments and environments, billing, webhooks and collaborators. A final group runs local git commands such as status, commit, push, pull, log and clone.

It needs a personal access token in `GITHUB_TOKEN`, and the README maps tasks to scopes, for example `workflow` for Actions and `read:org` for org billing. GitHub Enterprise is supported through host, REST and GraphQL URL variables.

The registry entry advertises 70 tools. The README notes an update of `simple-git` to v4.0.2 for security advisories and links a SECURITY.md. It is MIT licensed.

## Features

- **Pull request handling:** Create, list, update, review and merge pull requests.
- **Actions control:** List workflows and runs, rerun, cancel, dispatch and fetch artifacts.
- **Deployments:** Create deployments and statuses and list environments.
- **Billing reports:** Read Actions billing for users and organisations.
- **Branch protection:** Read, update or delete protection rules.
- **Raw GraphQL:** Run custom queries and mutations or a repository overview.
- **Local git:** Run status, commit, push, pull, log and clone locally.
- **Enterprise hosts:** Point to a GitHub Enterprise REST and GraphQL endpoint.

## Good for

- Rerun a failed workflow from chat
- Merge a reviewed pull request
- Check Actions minutes for an organisation
- Create a release and tag
- Audit branch protection settings

## Install

### Claude Code (Terminal)

```sh
claude mcp add github-cicd --env GITHUB_TOKEN='<GITHUB_TOKEN>' -- npx -y @kinus/github-cicd-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "github-cicd": {
      "command": "npx",
      "args": [
        "-y",
        "@kinus/github-cicd-mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "github-cicd": {
      "command": "npx",
      "args": [
        "-y",
        "@kinus/github-cicd-mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "github-cicd": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@kinus/github-cicd-mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "github-cicd": {
      "command": "npx",
      "args": [
        "-y",
        "@kinus/github-cicd-mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "github-cicd": {
      "command": "npx",
      "args": [
        "-y",
        "@kinus/github-cicd-mcp"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

## Tools

- `github_list_workflow_runs`: List runs of a workflow.
- `github_rerun_workflow`: Rerun a workflow run.
- `github_dispatch_workflow`: Trigger a workflow dispatch.
- `github_create_pull_request`: Open a pull request.
- `github_merge_pull_request`: Merge a pull request.
- `github_create_deployment`: Create a deployment.
- `github_get_org_billing_overview`: Read an organisation's billing overview.
- `github_graphql_query`: Run a GraphQL query.
- `git_commit`: Commit locally with git.

## FAQ

### What credentials does it need?

A GitHub personal access token in GITHUB_TOKEN, with scopes matched to the tools you use.

### Does it support GitHub Enterprise?

Yes, via GITHUB_HOST, GITHUB_API_URL and GITHUB_GRAPHQL_URL.

### How do I install it?

Run it with npx using @kinus/github-cicd-mcp, or build from source.

### What licence is it?

MIT.

### Is GitHub CI/CD MCP Server free?

Yes. GitHub CI/CD MCP Server is open source, so you can use and self-host it for free.

### How do I add GitHub CI/CD MCP Server to Claude Code?

Run this command in your terminal: claude mcp add github-cicd --env GITHUB_TOKEN='<GITHUB_TOKEN>' -- npx -y @kinus/github-cicd-mcp

### What are the best alternatives to GitHub CI/CD MCP Server?

The closest alternatives to GitHub CI/CD MCP Server are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/github-ci-cd-mcp-server
