GitHub

You can run and use this MCP server to access employee-centric GitHub activity data via AI agents. It abstracts GitHub PRs, reviews, comments, and code changes, offering semantic endpoints you can call in your MCP client to build analytics, performance reviews, and orchestration workflows.

How to use

Launch the MCP server as a stdio host under your MCP client and call the provided tools to retrieve and analyze GitHub activity. You can quickly obtain a comprehensive overview with a single call to github.getUserRepoStats, then drill into authored PRs, reviews, comments, and potential impact using the other tools. Default time ranges cover the last 3 months if you omit from and to in tool inputs.

How to install

Prerequisites: ensure you have Node.js 20+ installed on your system.

Install dependencies and build the MCP server package, then prepare to run it via an MCP client.

npm install
npm run build

Configuration and running

Configure your MCP client to load the GitHub MCP server as a stdio service. Use the following MCP configuration snippet to register the server under a suitable name.

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": ["dist/mcp/server.js"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

Security and tokens

You must provide a GitHub Personal Access Token with appropriate scopes. The server expects the token to be supplied in environment variable GITHUB_TOKEN when launched by your MCP client.

Troubleshooting

If you encounter authentication or rate-limit errors, verify that your GITHUB_TOKEN has the required scopes (repo, read:org, read:user where applicable) and that your token is correctly passed to the server via the environment. For startup issues, ensure the build output exists at dist/mcp/server.js and that the MCP client is configured to start the stdio server as shown in the configuration snippet.

Notes

This server exposes a set of tools for working with GitHub data programmatically. Each tool returns structured data that is easy to parse in agents and orchestrators. All tool inputs require at least one repository; time ranges are optional and default to the last 3 months if omitted.

Available tools

github.getAuthoredPRs

Fetch all PRs authored by a user in a given time range across specified repositories, returning metadata such as PR id, repository, title, creation and merge times, state, and changes.

github.getPRReviews

Fetch PR reviews submitted by the user across the provided repositories, including review state, associated PR details, and submission times.

github.getReviewComments

Fetch inline and general review comments grouped by PR, with per-PR totals and date ranges.

github.getCommentImpact

Analyze whether review comments led to code changes, returning impact flags, confidence scores, and supporting evidence.

github.getUserComments

Fetch all comments authored by a user for PRs in the given repositories within a time range, combining review and issue comments into a unified structure.

github.getUserRepoStats

Aggregate repository statistics for a user, including PRs, comments, reviews, and code changes over a specified time frame.