Skip to content
MCP server

GitHub (read-only)

Read-only GitHub repos, issues, PRs and commits with benchmark-tuned tool descriptions

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API
Runs
Locally
Version
1.2.0
Listing updated
1 day ago

About GitHub (read-only)

GitHub (read-only) is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

This Python server is as much a benchmarking project as a GitHub connector. The author measured how often a small local model picks the right tool with the right arguments, then rewrote tool descriptions and input handling. Accuracy went from 63% to 95% on the tuned questions and 60% to 90% on held-out ones. Most of the gain, 17 of 32 points, came from accepting bare repository names rather than owner/name, with 8 from stating the limit range and 7 from rewording.

Six tools cover listing repositories and reading repositories, open issues, issue search, pull requests and recent commits. Access is least-privilege: a fine-grained, read-only token with Metadata, Contents, Issues and Pull requests permissions stays in the server process and never reaches the model. The server retries with backoff, handles rate limits and caches with ETags.

A GITHUB_MCP_TOOLSET variable chooses v2 (default) or the v1 and v1b baselines. The repository also includes the evaluation harness and a results dashboard. Known gaps include merged PRs, sorting by stars and closed issues.

Install

Run in a terminal

claude mcp add github-mcp --env GITHUB_TOKEN='<GITHUB_TOKEN>' -- uvx github-mcp-readonly

Add to claude_desktop_config.json

{
  "mcpServers": {
    "github-mcp": {
      "command": "uvx",
      "args": [
        "github-mcp-readonly"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "github-mcp": {
      "command": "uvx",
      "args": [
        "github-mcp-readonly"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "github-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "github-mcp-readonly"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "github-mcp": {
      "command": "uvx",
      "args": [
        "github-mcp-readonly"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "github-mcp": {
      "command": "uvx",
      "args": [
        "github-mcp-readonly"
      ],
      "env": {
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}

Configuration

  • GITHUB_TOKENFine-grained GitHub token with read-only access (Metadata, Contents, Issues, Pull requests).Required
  • GITHUB_MCP_TOOLSETTool descriptions to serve: v2 (default, optimized), v1 or v1b (benchmark baselines).

Tools this server provides (6)

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

list_repositories
Lists repositories.
get_repository
Gets one repository.
list_open_issues
Lists open issues.
search_issues
Searches issues.
list_pull_requests
Lists pull requests.
get_recent_commits
Gets recent commits.

What it does

Six read-only tools
Repositories, issues, pull requests and commits.
Bare repo names
Accepts a repository name without the owner prefix.
Least-privilege token
Fine-grained read-only token kept out of the model.
Rate-limit handling
Retries with backoff, ETag caching and exact totals.
Switchable descriptions
Choose v2 or baseline v1 and v1b tool descriptions.
Reusable benchmark
Harness can benchmark other MCP servers.

Good for

  • Ask an assistant about open issues across your repos
  • Review recent commits for a repository
  • Search issues without giving write access
  • Study how tool descriptions affect model accuracy

Pricing

Open source

Free; requires your own GitHub token

Prices change. Check abdulmuhaiminkhan.github.io before you buy.

GitHub (read-only) FAQ

What token does it need?

A fine-grained GitHub token with read-only Metadata, Contents, Issues and Pull requests access.

Can it change anything on GitHub?

No, it is read-only.

What does it not support yet?

The README lists merged PRs, sorting by stars and closed issues as unmet requests.

How do I install it?

From PyPI as github-mcp-readonly, running over stdio.

Is GitHub (read-only) free?

Yes. GitHub (read-only) is open source, so you can use and self-host it for free.

How do I add GitHub (read-only) to Claude Code?

Run this command in your terminal: claude mcp add github-mcp --env GITHUB_TOKEN='<GITHUB_TOKEN>' -- uvx github-mcp-readonly

What are the best alternatives to GitHub (read-only)?

The closest alternatives to GitHub (read-only) are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to GitHub (read-only)

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools