GitHub CI/CD MCP Server

Official registry Developer tools

GitHub CI/CD MCP server with 70 tools for repos, PRs, Actions, deployments, billing, and more.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @kinus/github-cicd-mcp
Claude Code
claude mcp add github-ci-cd-mcp-server -e 'GITHUB_TOKEN=<your github_token>' -e 'GITHUB_HOST=<GITHUB_HOST>' -e 'GITHUB_API_URL=<GITHUB_API_URL>' -e 'GITHUB_GRAPHQL_URL=<GITHUB_GRAPHQL_URL>' -- npx -y @kinus/github-cicd-mcp@1.2.2
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "github-ci-cd-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@kinus/github-cicd-mcp@1.2.2"
            ],
            "env": {
                "GITHUB_TOKEN": "<your github_token>",
                "GITHUB_HOST": "<GITHUB_HOST>",
                "GITHUB_API_URL": "<GITHUB_API_URL>",
                "GITHUB_GRAPHQL_URL": "<GITHUB_GRAPHQL_URL>"
            }
        }
    }
}

Environment variables

  • GITHUB_TOKEN required secret GitHub personal access token for authentication
  • GITHUB_HOST GitHub Enterprise hostname (optional, defaults to github.com)
  • GITHUB_API_URL GitHub Enterprise REST API base URL (optional)
  • GITHUB_GRAPHQL_URL GitHub Enterprise GraphQL endpoint (optional)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. github-cicd-mcp
  2. Install
  3. Authentication
  4. Tool reference
  5. GitHub Enterprise
  6. Development
  7. Publish your own fork
  8. License

github-cicd-mcp

GitHub CI/CD MCP server for Model Context Protocol.

Model Context Protocol (MCP) server for GitHub REST and GraphQL — built for CI/CD and DevOps workflows in Cursor, Claude Desktop, and other MCP clients.

Give your AI agent tools to manage repos, commits, pull requests, issues, GitHub Actions, deployments, billing, releases, branch protection, webhooks, and local git — without leaving the editor.


Install

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

Set GITHUB_TOKEN (or GH_TOKEN) in your system environment, or replace ${env:GITHUB_TOKEN} with a secret reference your client supports.

From source
git clone https://github.com/devstephenke-sys/Github-Free-MCPs.git
cd Github-Free-MCPs
npm install
npm run build

Point MCP at node /absolute/path/to/github-cicd-mcp/dist/index.js.


Authentication

Create a personal access token:

NeedScopes / permissions
Repos, PRs, commits, issuesrepo or fine-grained Contents, Pull requests, Issues
Actionsworkflow
Org billingread:org + org billing role
Admin (branch protection, webhooks)Admin access on the repo/org

Never commit tokens. Use environment variables only.

⚠️ Security: See SECURITY.md for security policies and best practices.

Recent Security Update (v1.2.3): Updated simple-git to v4.0.2 to address critical security vulnerabilities (CVE-2026-102828, CVE-2026-102826, CVE-2026-102827, CVE-2026-6951).


Tool reference

Core & repos

github_get_authenticated_user, github_get_rate_limit, github_create_repository, github_get_repository, github_list_repositories, github_create_branch, github_fork_repository

Commits & CI status

github_list_commits, github_get_commit, github_compare_commits, github_create_commit, github_get_combined_status, github_list_check_runs_for_ref

Pull requests

github_create_pull_request, github_list_pull_requests, github_get_pull_request, github_merge_pull_request, github_update_pull_request, github_list_pull_request_files, github_create_pull_request_review

Issues

github_create_issue, github_list_issues, github_get_issue, github_update_issue, github_add_issue_comment, github_list_issue_comments

Releases & tags

github_list_releases, github_get_release_by_tag, github_create_release, github_list_tags, github_create_tag

Branches & protection

github_list_branches, github_get_branch, github_get_branch_protection, github_update_branch_protection, github_delete_branch_protection

GitHub Actions

github_list_workflows, github_list_workflow_runs, github_get_workflow_run, github_list_workflow_jobs, github_rerun_workflow, github_cancel_workflow_run, github_dispatch_workflow, github_list_actions_secrets, github_list_actions_variables, github_list_workflow_run_artifacts, github_download_workflow_artifact

Deployments (CD)

github_list_deployments, github_create_deployment, github_create_deployment_status, github_list_environments

Billing

github_get_user_billing_actions, github_get_org_billing_actions, github_get_org_billing_overview, github_get_org_billing_usage_report

Webhooks & access

github_list_webhooks, github_create_webhook, github_delete_webhook, github_list_collaborators, github_add_collaborator, github_list_teams

GraphQL

github_graphql_query, github_graphql_mutation, github_graphql_repository_overview

Local git

git_status, git_commit, git_push, git_pull, git_log, git_clone


GitHub Enterprise

  • GITHUB_HOST — hostname (when not github.com)
  • GITHUB_API_URL — REST base, e.g. https://github.example.com/api/v3
  • GITHUB_GRAPHQL_URL — GraphQL endpoint override

Development

npm install
npm run build
npm run verify

Publish your own fork

See RELEASING.md for:

  • Public GitHub repo setup
  • npm publish (npm publish --access public)
  • GitHub Releases and optional MCP directory listings

License

MIT

Frequently asked questions

What is GitHub CI/CD MCP Server?

GitHub CI/CD MCP server with 70 tools for repos, PRs, Actions, deployments, billing, and more.

How do I install GitHub CI/CD MCP Server?

It runs on your machine. In Claude Code: claude mcp add github-ci-cd-mcp-server -e 'GITHUB_TOKEN=<your github_token>' -e 'GITHUB_HOST=<GITHUB_HOST>' -e 'GITHUB_API_URL=<GITHUB_API_URL>' -e 'GITHUB_GRAPHQL_URL=<GITHUB_GRAPHQL_URL>' -- npx -y @kinus/github-cicd-mcp@1.2.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does GitHub CI/CD MCP Server need an API key?

Yes. It expects GITHUB_TOKEN, which you set in its configuration.

Is GitHub CI/CD MCP Server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains GitHub CI/CD MCP Server?

It is published by devstephenke-sys. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.