How to Set Up the GitHub MCP Server for Repository Management

Connect your AI agent to GitHub repositories. Create issues, manage pull requests, search code, and automate repository workflows through MCP.

GitHubgitrepositoriesautomationdeveloper tools

Set Up the GitHub MCP Server

The GitHub MCP server provides comprehensive access to GitHub's API, enabling AI agents to manage repositories, issues, pull requests, and more.

Prerequisites

▸A GitHub account
▸A GitHub Personal Access Token (PAT)
▸Node.js 18+

Creating a Personal Access Token

▸Go to GitHub Settings → Developer Settings → Personal Access Tokens → Fine-grained tokens
▸Click Generate new token
▸
Set permissions:
- ▸Repository access: Select repositories or all
- ▸Permissions: Contents (Read/Write), Issues (Read/Write), Pull Requests (Read/Write)
▸Copy the generated token

Configuration

json

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Available Tools

The GitHub server exposes a rich set of tools:

Repository Operations

▸
code
```
create_repository
```
— Create new repos
▸
code
```
search_repositories
```
— Search GitHub repos
▸
code
```
get_file_contents
```
— Read files from repos
▸
code
```
push_files
```
— Create or update files
▸
code
```
create_branch
```
— Create new branches

Issue Management

▸
code
```
create_issue
```
— Create new issues
▸
code
```
list_issues
```
— List and filter issues
▸
code
```
update_issue
```
— Modify existing issues
▸
code
```
add_issue_comment
```
— Comment on issues

Pull Request Operations

▸
code
```
create_pull_request
```
— Open new PRs
▸
code
```
list_pull_requests
```
— List PRs with filters
▸
code
```
merge_pull_request
```
— Merge PRs
▸
code
```
get_pull_request_diff
```
— View PR diffs

Code Search

▸
code
```
search_code
```
— Search across repositories
▸
code
```
search_issues
```
— Search issues and PRs

Example Workflows

Code Review Assistant

code

"Review the latest pull request on my-org/my-repo and suggest improvements"

Issue Triage

code

"List all open issues labeled 'bug' in my-repo and categorize them by severity"

Repository Analysis

code

"Analyze the codebase structure of my-org/my-repo and create a documentation outline"

Security Considerations

▸Use fine-grained tokens with minimum required permissions
▸Rotate tokens regularly
▸Never commit tokens to repositories
▸Consider using separate tokens for read-only vs. write operations