GitHub MCP Server

Features

• Automatic Branch Creation: When creating/updating files or pushing changes, branches are automatically created if they don't exist

• Comprehensive Error Handling: Clear error messages for common issues

• Git History Preservation: Operations maintain proper Git history without force pushing

• Batch Operations: Support for both single-file and multi-file operations

• Advanced Search: Support for searching code, issues/PRs, and users

Tools

1. create_or_update_file

2. push_files

3. search_repositories

4. create_repository

5. get_file_contents

6. create_issue

7. create_pull_request

8. fork_repository

9. create_branch

10. list_issues

11. update_issue

12. add_issue_comment

13. search_code

14. search_issues

15. search_users

16. list_commits

• Gets commits of a branch in a repository

• Inputs:

• Returns: List of commits

1. get_issue

• Gets the contents of an issue within a repository

• Inputs:

• Returns: Github Issue object & details

1. get_pull_request

• Get details of a specific pull request

• Inputs:

• Returns: Pull request details including diff and review status

1. list_pull_requests

• List and filter repository pull requests

• Inputs:

• Returns: Array of pull request details

1. create_pull_request_review

• Create a review on a pull request

• Inputs:

• Returns: Created review details

1. merge_pull_request

• Merge a pull request

• Inputs:

• Returns: Merge result details

1. get_pull_request_files

• Get the list of files changed in a pull request

• Inputs:

• Returns: Array of changed files with patch and status details

1. get_pull_request_status

• Get the combined status of all status checks for a pull request

• Inputs:

• Returns: Combined status check results and individual check details

1. update_pull_request_branch

• Update a pull request branch with the latest changes from the base branch (equivalent to GitHub's "Update branch" button)

• Inputs:

• Returns: Success message when branch is updated

1. get_pull_request_comments

• Get the review comments on a pull request

• Inputs:

• Returns: Array of pull request review comments with details like the comment text, author, and location in the diff

1. get_pull_request_reviews

• Get the reviews on a pull request

• Inputs:

• Returns: Array of pull request reviews with details like the review state (APPROVED, CHANGES_REQUESTED, etc.), reviewer, and review body

Search Query Syntax

Code Search

• language:javascript: Search by programming language

• repo:owner/name: Search in specific repository

• path:app/src: Search in specific path

• extension:js: Search by file extension

• Example: q: "import express" language:typescript path:src/

Issues Search

• is:issue or is:pr: Filter by type

• is:open or is:closed: Filter by state

• label:bug: Search by label

• author:username: Search by author

• Example: q: "memory leak" is:issue is:open label:bug

Users Search

• type:user or type:org: Filter by account type

• followers:>1000: Filter by followers

• location:London: Search by location

• Example: q: "fullstack developer" location:London followers:>100

Setup

Personal Access Token

• Go to Personal access tokens (in GitHub Settings > Developer settings)

• Select which repositories you'd like this token to have access to (Public, All, or Select)

• Create a token with the repo scope ("Full control of private repositories")

• Copy the generated token

Usage with Claude Desktop

Docker

NPX

Build

License

GitHub MCP Server

Features

• Automatic Branch Creation: When creating/updating files or pushing changes, branches are automatically created if they don't exist

• Comprehensive Error Handling: Clear error messages for common issues

• Git History Preservation: Operations maintain proper Git history without force pushing

• Batch Operations: Support for both single-file and multi-file operations

• Advanced Search: Support for searching code, issues/PRs, and users

Tools

1. create_or_update_file

2. push_files

3. search_repositories

4. create_repository

5. get_file_contents

6. create_issue

7. create_pull_request

8. fork_repository

9. create_branch

10. list_issues

11. update_issue

12. add_issue_comment

13. search_code

14. search_issues

15. search_users

16. list_commits

• Gets commits of a branch in a repository

• Inputs:

• Returns: List of commits

1. get_issue

• Gets the contents of an issue within a repository

• Inputs:

• Returns: Github Issue object & details

1. get_pull_request

• Get details of a specific pull request

• Inputs:

• Returns: Pull request details including diff and review status

1. list_pull_requests

• List and filter repository pull requests

• Inputs:

• Returns: Array of pull request details

1. create_pull_request_review

• Create a review on a pull request

• Inputs:

• Returns: Created review details

1. merge_pull_request

• Merge a pull request

• Inputs:

• Returns: Merge result details

1. get_pull_request_files

• Get the list of files changed in a pull request

• Inputs:

• Returns: Array of changed files with patch and status details

1. get_pull_request_status

• Get the combined status of all status checks for a pull request

• Inputs:

• Returns: Combined status check results and individual check details

1. update_pull_request_branch

• Update a pull request branch with the latest changes from the base branch (equivalent to GitHub's "Update branch" button)

• Inputs:

• Returns: Success message when branch is updated

1. get_pull_request_comments

• Get the review comments on a pull request

• Inputs:

• Returns: Array of pull request review comments with details like the comment text, author, and location in the diff

1. get_pull_request_reviews

• Get the reviews on a pull request

• Inputs:

• Returns: Array of pull request reviews with details like the review state (APPROVED, CHANGES_REQUESTED, etc.), reviewer, and review body

Search Query Syntax

Code Search

• language:javascript: Search by programming language

• repo:owner/name: Search in specific repository

• path:app/src: Search in specific path

• extension:js: Search by file extension

• Example: q: "import express" language:typescript path:src/

Issues Search

• is:issue or is:pr: Filter by type

• is:open or is:closed: Filter by state

• label:bug: Search by label

• author:username: Search by author

• Example: q: "memory leak" is:issue is:open label:bug

Users Search

• type:user or type:org: Filter by account type

• followers:>1000: Filter by followers

• location:London: Search by location

• Example: q: "fullstack developer" location:London followers:>100

Setup

Personal Access Token

• Go to Personal access tokens (in GitHub Settings > Developer settings)

• Select which repositories you'd like this token to have access to (Public, All, or Select)

• Create a token with the repo scope ("Full control of private repositories")

• Copy the generated token

Usage with Claude Desktop

Docker

NPX

Build

License