Github

You can run a GitHub MCP Server to let large language models interact with GitHub data and actions through the Model Context Protocol. It enables searching repositories, issues, commits, code, users, topics, and more, all via a programmable MCP interface.

How to use

Use an MCP client to call the available tools and retrieve data from GitHub. You can search for repositories, issues, commits, code, users, topics, and labels; list issues and pull requests; and fetch specific issues or pull requests. Each tool has its own required inputs and optional parameters to refine results. Combine multiple tool calls to build workflows like code research, project triage, or repository discovery.

How to install

Prerequisites you need before starting:

• Node.js installed on your system.

• A package manager you are comfortable with (npm, pnpm, or npx).

How to install

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "github-mcp-server"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_personal_github_access_token"
      }
    }
  }
}

How to install

Next, configure your MCP client with the above server configuration so that it can communicate with the GitHub MCP Server. The configuration uses the npx command to run the server module and passes the required access token as an environment variable.

Additional sections

Configuration and usage details are provided below to ensure you can operate the GitHub MCP Server securely and efficiently. Follow the steps to start, test, and integrate the server into your workflows.

Available tools

search_repositories

Search GitHub repositories by a query and paginate results with page and per_page. Optional inputs control how results are ordered and limited.

search_issues

Search issues across repositories with query, pagination, and sorting options such as order and sort field.

search_commits

Search commits in a repository by a query with pagination and sorting controls like order and sort field.

search_code

Search code within a repository using a query and pagination controls.

search_users

Search users on GitHub by a query with pagination and optional sorting by followers, repositories, or joined date.

search_topics

Search topics across GitHub repositories using a query and pagination.

search_labels

Search labels within a repository with query, pagination, and optional sort settings.

list_repositories_issues

List issues from a specific repository with filtering options such as labels, milestone, assignee, creator, mentioned, and time range.

get_issue

Retrieve a specific issue from a repository by owner, repo, and issue number.

list_repositories_pull_requests

List pull requests for a repository with filtering by head/base branch, sort direction, and pagination.

get_pull_request

Get details for a specific pull request by owner, repo, and pull request number.