home / mcp / github projects mcp server

GitHub Projects MCP Server

Provides an MCP server to query GitHub Projects data, including repository contents, issues, pulls, and project metadata via a unified MCP interface.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jamescalam-github-projects-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/you/Documents/mcp/github-projects",
        "run",
        "github_projects/mcp/app.py"
      ],
      "env": {
        "GITHUB_PAT": "YOUR_GITHUB_PAT"
      }
    }
  }
}

This MCP server enables scraping data from GitHub Projects by running a local MCP process through the UV runtime. It uses a GitHub Personal Access Token (PAT) to access repository data when needed and exposes MCP methods you can call from any MCP client.

How to use

To use this server, connect your MCP client to the locally running UV-based MCP server. You will run the server in the same environment where your GitHub PAT is available as an environment variable. After starting the server, open your MCP client’s tool explorer and look for the methods exposed under the GitHub Projects MCP to fetch project data, issues, pull requests, and related metadata.

How to install

Prerequisites you need to have before starting: Node.js and Python are commonly used in MCP workflows, but you only need the components described here to run this server and its tooling.

Install the MCP inspector tooling to view and manage MCP servers and their tools locally.

npm install -g @modelcontextprotocol/inspector
```
```bash
mcp-inspector

MCP server configuration (stdio)

{
  "mcpServers": {
    "github_projects": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/jamesbriggs/Documents/aurelio/corp-agent/github-projects",
        "run",
        "github_projects/mcp/app.py"
      ],
      "env": {
        "GITHUB_PAT": "github_pat_..."
      }
    }
  }
}

Available tools

@mcp.tool

Exposed tool endpoints for interacting with GitHub Projects data through the MCP server.