GitHub MCP

---
name: mcp-github
description: |
  Trigger when the user asks about GitHub issues, PRs, repos, or wants to
  interact with GitHub without leaving the editor.
allowed-tools:
  - Bash(npx @anthropic/mcp-server-github *)
  - Bash(gh *)
  - Read
---

# GitHub MCP

MCP server for GitHub: manage issues, PRs, repos, actions, and code search
without leaving your editor.

## Prerequisites

- GitHub personal access token with `repo` scope
- Set as `GITHUB_TOKEN` environment variable

## Setup

Add to your MCP config (`~/.claude/mcp.json`):

```json
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "<your-token>"
      }
    }
  }
}
```

## Available Tools

- **list_issues** - List and filter issues in a repository
- **create_issue** - Create a new issue with labels and assignees
- **get_pull_request** - Get PR details, diff, and review status
- **create_pull_request** - Create a PR from the current branch
- **search_code** - Search code across repositories
- **list_repos** - List repositories for a user or organization
- **get_file** - Read a file from a repository

## Steps

1. Configure the MCP server with your GitHub token
2. Use `list_issues` to see open issues
3. Use `search_code` to find code patterns across repos
4. Use `create_pull_request` for PR workflows