How do I install Github Brain?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Github Brain need an API key?

No required environment variable is listed on this record.

What transport does Github Brain use?

Github Brain runs locally over stdio.

When was Github Brain last checked?

Last checked 2026-10-27. An experimental GitHub MCP server with local database.

Servidor MCP Github Brain

Potencia tu agente

Añadir este servidor

Install from the publisher. Not a PlugMCP endpoint.

Ejecutar en PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Ejecutar en PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Abrir

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-10-27

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

GitHub Brain is an experimental MCP server for summarizing GitHub discussions, issues, and pull requests. Answer questions like:

What are the contributions of user X in the last month?
Summarize this month's discussions.

https://github.com/user-attachments/assets/80910025-9d58-4367-af00-bf4c51e6ce86

GitHub Brain complements (but does not replace) the official GitHub MCP server. It stores GitHub data in a local database for:

Fast responses
More than the standard 100-item API limit
Token-efficient Markdown output

GitHub Brain is programmed in Markdown.

Installation

npm i -g github-brain

Rerun to update. sudo may be required on some systems.

Alternatively use npx to run without installing globally and needing sudo.

npx github-brain@latest

Usage

github-brain

Or with npx:

npx github-brain@latest

Launches the interactive TUI where you can:

Setup - Configure authentication and settings
- Login with GitHub (OAuth) - Recommended for most users
- Login with Personal Access Token - For fine-grained tokens or when OAuth is unavailable
- Open configuration file - Edit .env directly
Pull - Populate the local database with GitHub data

Re-run pull anytime to update the database with new GitHub data.

The app loads environment variables from a .env file in the GitHub Brain's home directory - ~/.github-brain by default.

GITHUB_TOKEN=your_github_token
ORGANIZATION=my-org

Argument	Description
`-m`	Home directory. Default: `~/.github-brain`

Use [fine-grained personal access tokens](https://github.com/settings/personal-access-tokens).

**Private organizations:** Token needs read access to discussions, issues, metadata, and pull requests. [Generate token](https://github.com/settings/personal-access-tokens/new?name=github-brain&description=http%3A%2F%2Fgithub.com%2Fwham%2Fgithub-brain&issues=read&pull_requests=read&discussions=read).

**Public organizations:** Any token works (data is publicly accessible).

MCP Server

Start the MCP server using the local database:

github-brain mcp

Or with npx:

npx github-brain@latest mcp

Argument	Variable	Description
`-o`	`ORGANIZATION`	GitHub organization. Required.
`-m`		Home directory. Default: `~/.github-brain`

MCP Configuration

Claude

Add to the Claude MCP configuration file:

{
  "mcpServers": {
    "github-brain": {
      "type": "stdio",
      "command": "github-brain",
      "args": ["mcp"]
    }
}

Or with npx:

{
  "mcpServers": {
    "github-brain": {
      "type": "stdio",
      "command": "npx",
      "args": ["github-brain@latest", "mcp"]
    }
}

Merge with existing mcpServers if present.

VS Code

Add to the VS Code MCP configuration file:

{
  "servers": {
    "github-brain": {
      "type": "stdio",
      "command": "github-brain",
      "args": ["mcp"],
      "version": "0.0.1"
    }
  }
}

Or with npx:

{
  "servers": {
    "github-brain": {
      "type": "stdio",
      "command": "npx",
      "args": ["github-brain@latest", "mcp"],
      "version": "0.0.1"
    }
  }
}

Merge with existing servers if present.

Development

scripts/run builds and runs github-brain with the checkout directory as home -m (database in db/, config in .env).

Añadir este servidor

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Github Brain?

Does Github Brain need an API key?

What transport does Github Brain use?

When was Github Brain last checked?

Documentation

Installation

Usage

MCP Server

MCP Configuration

Claude

VS Code

Development