# github-mcp-server

This skill connects an agent to GitHub through MCP for repository browsing, issue and pull request work, GitHub Actions checks, and code analysis.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 243 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/github-mcp-server/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/github-mcp-server

## What it does

The skill sets up access to GitHub's official MCP Server through natural-language requests. An agent can inspect repository files and structure, search code, review commits, create or update issues, work with pull requests, and inspect GitHub Actions runs. It also exposes repository, notification, and other GitHub toolsets.

A GitHub Personal Access Token is needed for authenticated access and can be supplied through an environment variable or an authorization header. The available toolsets include `repos`, `issues`, `pulls`, `actions`, `search`, `gists`, and `notifications`; Docker is available for a local server setup. Without a PAT, the server cannot access GitHub, while GitHub Enterprise Server also needs `GITHUB_HOST`.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill github-mcp-server -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/github-mcp-server/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/github-mcp-server/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill github-mcp-server -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/github-mcp-server/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill github-mcp-server -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/github-mcp-server/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/github-mcp-server
```

2. **Manually: put the files in place**
- File: `.github/skills/github-mcp-server/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill github-mcp-server -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/github-mcp-server
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/github-mcp-server/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill github-mcp-server -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/github-mcp-server/SKILL.md

## When to use it
- browse files and search code in a repository
- create and update GitHub issues
- inspect pull requests and their changes
- check GitHub Actions runs and failures
- review commits and project structure

## Example prompts
- Show open issues labeled bug in `github/github-mcp-server`.
- Find every function that uses the GitHub API in `github/github-mcp-server`.
- Show recent GitHub Actions runs for CI in `github/github-mcp-server` and explain the failures.

## Similar
- [github-workflow-automation](https://affpapa.org/en/nevibecode/skills/sickn33-github-workflow-automation.md) — skill · 1500 installs
- [github-workflow](https://affpapa.org/en/nevibecode/skills/github-workflow.md) — skill · 829 installs
- [github-issue-workflow](https://affpapa.org/en/nevibecode/skills/github-issue-workflow.md) — skill · 3700 installs
- [github](https://affpapa.org/en/nevibecode/plugins/openai-github.md) — plugin · ★ 8052 repo stars
- [github-copilot-starter](https://affpapa.org/en/nevibecode/skills/github-copilot-starter.md) — skill · 8900 installs
- [github-ops](https://affpapa.org/en/nevibecode/skills/github-ops.md) — skill · 1600 installs

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
