epik-gh

A GitHub MCP server that wraps the gh CLI. It exposes GitHub operations as tools that an MCP client (such as Claude) can call directly.

What it does

epik-gh gives an MCP client read/write access to GitHub through a focused set of tools:

• Issues — list, get, create, edit, close, reopen, comment
• Pull requests — list, get, create, edit, close, merge, review, comment
• Branches — list, create, delete
• Labels — list, create, delete
• Repositories — get metadata, get default branch
• CI / Actions — list runs, get run details, fetch run logs
• Issue relationships — set/remove blocked-by, add/remove sub-issues, list relationships
• Projects V2 — list items, get item, set status, invalidate cache

All operations go through the gh CLI, so they run with whatever GitHub account gh auth login has authenticated.

Prerequisites

• Python 3.11+
• uv (recommended) or pip
• gh CLI installed and authenticated (gh auth login)

Installation

With uv (recommended)

uv tool install git+https://github.com/YOUR_ORG/epik-gh.git

Or clone and install locally:

git clone https://github.com/YOUR_ORG/epik-gh.git
cd epik-gh
uv tool install .

With pip

pip install git+https://github.com/YOUR_ORG/epik-gh.git

Configuring as a CoWork MCP server

Add the following to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "epik-gh": {
      "command": "/Users/YOUR_USERNAME/.local/bin/epik-gh"
    }
  }
}

Use the full path to the binary. Confirm it with:

which epik-gh

Authentication

epik-gh delegates all authentication to the gh CLI. Before using the server, make sure you are logged in:

gh auth login

To verify:

gh auth status