Skip to content
MCP server

GitHub CI/CD MCP Server

GitHub repo, pull request, Actions and deployment tools for CI/CD agents

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
1.2.2
Listing updated
today

Similar MCP servers

About GitHub CI/CD MCP Server

GitHub CI/CD MCP Server is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GITHUB_TOKENGitHub personal access token for authenticationRequired
  • GITHUB_HOSTGitHub Enterprise hostname (optional, defaults to github.com)
  • GITHUB_API_URLGitHub Enterprise REST API base URL (optional)
  • GITHUB_GRAPHQL_URLGitHub Enterprise GraphQL endpoint (optional)

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

MIT licence; requires a GitHub token

More servers for the same service

GitHub CI/CD MCP Server 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.

How AIPoweredBot checks servers