GitHub GraphQL MCP Server

Name: GitHub GraphQL MCP Server
Author: QuentinCody

@QuentinCody

Repository

About GitHub GraphQL MCP Server

No overview available yet

Basic information

Config

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

{
  "mcpServers": {
    "github-graphql-mcp-server": {
      "command": "python3",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is GitHub GraphQL MCP Server?

A Model Context Protocol (MCP) server that provides access to GitHub's GraphQL API. It exposes a single tool for executing arbitrary GraphQL queries and mutations against GitHub's API. It is designed for developers who want to integrate GitHub data into MCP‑compatible applications such as Claude for Desktop.

How to use GitHub GraphQL MCP Server?

Install Python 3.10+, clone the repository, set up a virtual environment, install dependencies with pip install -r requirements.txt, and run the server with GITHUB_TOKEN=your_token python github_graphql_mcp_server.py. For use with Claude for Desktop, add a configuration entry with absolute paths to the Python executable and the server script, plus the GITHUB_TOKEN environment variable.

Key features of GitHub GraphQL MCP Server

Execute any GraphQL query against GitHub’s API
Support for variables in GraphQL operations
Comprehensive error handling and reporting
Detailed documentation with example queries
Authenticated access via a GitHub Personal Access Token

Use cases of GitHub GraphQL MCP Server

Retrieve repository details (name, description, star count, owner)
Search for repositories by language, stars, or other criteria
Get user information and their top starred repositories
Execute custom GraphQL mutations against GitHub

FAQ from GitHub GraphQL MCP Server

What are the prerequisites for running the server?

Python 3.10 or higher and a GitHub Personal Access Token (PAT) are required.

How do I install and run the server?

Clone the repository, create a virtual environment, install dependencies with pip install -r requirements.txt, set the GITHUB_TOKEN environment variable, and run python github_graphql_mcp_server.py.

How do I configure the server with Claude for Desktop?

Add a JSON entry to your Claude Desktop configuration that specifies the full path to the virtual environment’s Python interpreter, the full path to the server script, and the GITHUB_TOKEN environment variable.

What are the GitHub API rate limits?

Authenticated requests are limited to 5,000 per hour; unauthenticated requests to 60 per hour.

What common errors might I encounter?

Errors include spawn python ENOENT (use full path to Python), ModuleNotFoundError (activate venv and install dependencies), and Error: GitHub token not found (set the GITHUB_TOKEN environment variable).