GitHub MCP

GitHub MCP server for AI-driven peer code reviews and developer issue management.

Setup

cp .env.example .env
# Edit .env and add your GITHUB_TOKEN

uv sync

Run

uv run github-mcp

Claude Desktop / Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "github": {
      "command": "uv",
      "args": ["--directory", "/path/to/github-mcp", "run", "github-mcp"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Or run this command:

claude mcp add github-mcp --env GITHUB_TOKEN="ghp_your_token_here" -- uv --directory "/path/to/github-mcp" run github-mcp 

Workflow: Issue → Branch → PR

gh_get_issue          # read the ticket
gh_create_branch      # create fix/issue-42-slug from main
# ... make code changes ...
gh_create_pull_request  # open PR with "Closes #42" in body
gh_request_pr_reviewers # add reviewers
gh_submit_review        # AI review: approve or request changes
gh_merge_pull_request   # squash merge when approved
gh_delete_branch        # clean up

Tools

Branches

• gh_list_branches — list branches with protection status
• gh_get_branch — branch detail + latest commit SHA
• gh_create_branch — create from branch name, tag, or SHA
• gh_delete_branch — delete after merge

Pull Requests (Write)

• gh_create_pull_request — open PR with labels, assignees, reviewers, draft mode
• gh_update_pull_request — update title/body/base/state/draft
• gh_merge_pull_request — merge/squash/rebase
• gh_request_pr_reviewers — add reviewers or teams

Code Review

• gh_list_pull_requests — list PRs
• gh_get_pull_request — PR metadata
• gh_get_pull_request_files — per-file diffs (start here for reviews)
• gh_get_pull_request_diff — raw unified diff
• gh_get_pull_request_commits — commit list
• gh_get_pull_request_reviews — existing reviews
• gh_submit_review — post review with inline comments
• gh_post_review_comment — single inline comment

Issue Management

• gh_list_issues — list with filters
• gh_get_issue — full issue detail
• gh_get_issue_comments — issue comment thread
• gh_create_issue — plain issue
• gh_create_ai_issue — structured AI-analyzed issue (severity, root cause, fix, acceptance criteria)
• gh_update_issue — update fields
• gh_add_issue_comment — add comment
• gh_close_issue — close with reason
• gh_search_issues — search with GitHub qualifiers
• gh_list_repo_labels — available labels
• gh_list_milestones — available milestones

Utility

• gh_get_repo — repo metadata
• gh_get_file_content — file/directory content