Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/jamescalam/github-projects-mcp
cd github-projects-mcpThen follow the repository README for any remaining dependency or build steps.
Register it in Claude Code
claude mcp add -e "GITHUB_PAT=${GITHUB_PAT}" github-projects -- uv --directory /path/to/github-projects run github_projects/mcp/app.pyReplace any placeholder paths in the command with the real path on your machine.
GITHUB_PATMake your agent remember this setup
github-projects's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Scrapes data from GitHub Projects
- Retrieves repository issues and pull requests
- Accesses organizational metadata
- Supports private project data via PAT
Environment Variables
GITHUB_PATrequiredGitHub Personal Access Token with read-only permissions for repositories, issues, metadata, pull requests, members, and projects.Try it
Original README from jamescalam/github-projects-mcp
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.