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

Casefile

azimov777

One case file per task — shared by every session, agent and person that touches it. Self-hosted MCP server and live board. MIT.

3

Mcp-Warden

ermoluk

Local-first credential broker for MCP. AI coding agents (Claude Code, Cursor, Codex…) call APIs, SSH and databases through scoped presets; secrets stay in your OS keychain and never enter the agent's context.

4

Kilobat

seifip

Open-source Mac network diagnostics for AI agents and humans. Check connectivity, Wi-Fi, hotspots and traffic from the terminal or MCP.

Termany

thinkany-ai

Agent-Native Terminal

174

Moxie Docs

Jackalope-Dev

Automated codebase documentation for GitHub: searchable docs, MCP context for AI agents, doc drift detection, and Friday Cleanup PRs.

1
Advertise