Advertise
MCP.so
Sign In

MCP Github Cli

@michaelneale

Repository

Basic information

Category

Developer Tools

Transports

stdio

Author

michaelneale

About MCP Github Cli

a MCP server for github using the GH cli under the covers

MCP Github Cli config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-github-cli": {
      "command": "uvx",
      "args": [
        "mcp-github-cli"
      ]
    }
  }
}

MCP Github Cli tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is mcp-github-cli?

mcp-github-cli is an MCP server that provides focused GraphQL and REST API tools for interacting with GitHub. It leverages GitHub’s APIs to offer a streamlined set of powerful tools for retrieving rich data and performing common operations.

How to use mcp-github-cli?

Run with uvx mcp-github-cli from the command line. Prerequisites are installing the GitHub CLI (gh) and authenticating via gh auth login. Can be used with Goose or Claude. For a test run, execute uv run python main.py --test from the source directory.

Key features of mcp-github-cli

  • Get detailed authenticated user information via gh_get_me
  • Execute GraphQL queries for repos, users, PRs, and issues
  • Run custom GraphQL queries with gh_custom_graphql
  • Search repositories using the REST API
  • Create issues and pull requests via REST endpoints
  • List branches, commits, and repository contents

Use cases of mcp-github-cli

  • Retrieve the authenticated user’s GitHub profile
  • Get comprehensive repository information with a single GraphQL request
  • Search for repositories by language, stars, or other criteria
  • Create issues and pull requests programmatically from an MCP client
  • List branches and commits for a given repository

Frequently asked questions

1

What are the prerequisites?

Install the GitHub CLI (`gh`) via a package manager (e.g., `brew install gh` on macOS) and authenticate with `gh auth login`.

2

Can I use this server with Claude or Goose?

Yes, it can be used in Goose or Claude as an MCP server. Run it with `uvx mcp-github-cli`.

3

How do I test the server functionality?

Run `uv run python main.py --test` from the source directory. This verifies authentication, user info retrieval, GraphQL queries, REST searches, and other tools.

4

How do I publish an updated version?

Update the version in `pyproject.toml`, clean previous builds (`rm -rf dist/*`), build the package with `python -m build`, and upload to PyPI using `twine`.

5

What tools are available for custom queries?

You can execute custom GraphQL queries with `gh_custom_graphql(query, variables)` and custom REST API requests with `gh_rest_api(endpoint, method, data, query_params)`.

Comments

More Developer Tools MCP servers

Foremerge

naw103

Catch intent conflicts before code conflicts. The open-source coordination protocol for coding agents, built above Git.

50

OrangePro

Aamir Siddiqui

OrangePro local-first CLI + MCP server for behavior mapping, grounded test generation, and dynamic proof.

12

ArtiBot Cloud MCP - Zhijiangyun 智匠云

bofob

ArtiBot Cloud MCP (Zhijiangyun 智匠云) — cloud MCP server for robot manipulation data & GPU workloads. 15 tools: robot fleet management, data collection & video recording, post-processing pipelines, and benchmark evaluation

1

MilliGate (x402 Crypto Paywall)

MilliGate Core

MilliGate is a developer-first remote MCP server that functions as a secure crypto paywall. By leveraging the HTTP 402 (Payment Required) protocol, it allows developers to monetize AI agents, APIs, and digital infrastruc

Rams

HSLA0001 Inc.

Design review for UI code, inside your agent. quick_review checks the files you just changed in about ten seconds. review_files returns a 0-100 score and patches. verify_fixes confirms the fixes landed, free. review_url

Advertise