github-mcp

MCP server for the GitHub REST API — 1,112 tools covering all 44 API categories.

Auto-generated from GitHub's OpenAPI spec using a code generator that produces typed tool definitions with Zod validation.

Installation

npm install github-rest-mcp

Or from GitHub Packages:

npm install @eyalm321/github-mcp

Configuration

Set your GitHub Personal Access Token:

export GITHUB_TOKEN=ghp_your_token_here

Category Filter

By default all 1,112 tools are registered. To enable only specific categories:

export GITHUB_MCP_CATEGORIES=repos,issues,pulls,actions

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "github-rest-mcp"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here",
        "GITHUB_MCP_CATEGORIES": "repos,issues,pulls,actions,users,orgs,git,search"
      }
    }
  }
}

API Categories

Category	Tools	Category	Tools
actions	184	activity	32
agent-tasks	5	apps	37
billing	10	campaigns	5
checks	12	classroom	6
code-scanning	21	code-security	20
codes-of-conduct	2	codespaces	48
copilot	25	credentials	1
dependabot	22	dependency-graph	3
emojis	1	enterprise-team-memberships	6
enterprise-team-organizations	6	enterprise-teams	5
gists	20	git	13
gitignore	2	hosted-compute	6
interactions	9	issues	55
licenses	3	markdown	2
meta	5	migrations	22
oidc	8	orgs	108
packages	27	private-registries	6
projects	26	pulls	27
rate-limit	1	reactions	15
repos	201	search	7
secret-scanning	9	security-advisories	10
teams	32	users	47

Tool Naming

Tools follow the pattern github_{category}_{action}, derived from GitHub's operation IDs:

• github_repos_get — Get a repository
• github_issues_create — Create an issue
• github_pulls_list — List pull requests
• github_actions_list_workflow_runs — List workflow runs

Development

# Install dependencies
npm install

# Regenerate tools from OpenAPI spec
npm run generate

# Build
npm run build

# Run tests
npm test

# Start the server
npm start

Regenerating Tools

The tool files in src/tools/ are auto-generated from GitHub's OpenAPI spec. To update:

# Delete cached spec to force re-download
rm -f api-description.json

# Regenerate
npm run generate

License

MIT