Skip to main content
Glama
jamescalam

GitHub Projects MCP Server

by jamescalam

GitHub Projects

This project provides an MCP server for scraping data from GitHub Projects. For use on private projects you will need a Github Personal Access Token (PAT) with the following permissions:

Repository permissions:
- Contents: Read-only
- Issues: Read-only
- Metadata: Read-only
- Pull requests: Read-only

Organization permissions:
- Members: Read-only
- Projects: Read-only

Running with MCP

In Claude Desktop:

vim ~/Library/Application\ Support/Claude/claude_desktop_config.json
{
    "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_..."
            }
        }
    }
}

Digging in

We're leaving some quick notes on working and developing with MCP here. First, to view your MCP server and the various tools etc it contains we recommend:

npm install -g @modelcontextprotocol/inspector

Start the inspector app, inside the terminal you should see a localhost URL you can navigate to to open the UI.

mcp-inspector

Once inside the UI, start and connect to the MCP server with the following adapted to your particular environment. Note that these are the same inputs we provide to Claude Desktop:

Command: uv
Arguments: --directory /Users/jamesbriggs/Documents/aurelio/corp-agent/github-projects run python -m github_projects.app
Environment Variables (keep anything already here, just append): GITHUB_PAT: github_pat_...

Assuming the server started successfully, you can navigate to Tools and view the @mcp.tool methods that we have defined.

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    MCP (Model Context Protocol) server for GitHub API integration. This server provides comprehensive tools for interacting with GitHub repositories, issues, pull requests, branches, and code search through a unified interface.
    15
    2 npm
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    An MCP server that reads public GitHub Projects v2 boards (including item-level data like status and custom fields) without authentication, using official APIs and fallback methods for user-owned projects.
    5
    43 npm
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables natural language interaction with GitHub through an MCP server. Supports reading repos, issues, and PRs, as well as creating and editing issues with user confirmation.
    -