github-twin MCP Server

Name: github-twin MCP Server
Author: io.github.ChristopherDavenport

io.github.ChristopherDavenport/github-twin

Repository Registry

What is the github-twin MCP server?

Personal RAG over your GitHub history (commits, code, reviews), served to Claude Code over MCP.

How to install github-twin

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

GITHUB_TOKEN
secret
GitHub personal access token. Optional: github-twin can also pick the token up from `gh auth token` or from its own OAuth device-flow login (`gt auth login`).
ANTHROPIC_API_KEY
secret
Optional. Enables the Claude backend for `gt summarize`, `gt distill`, and `gt eval`. Defaults to local Ollama when unset.
GEMINI_API_KEY
secret
Optional. Enables the Gemini backend for embedding and the LLM seam. Vertex AI ADC via `GT_GEMINI_PROJECT` is also supported.
GT_PATHS__DATA_DIR
Optional. Override the on-disk data directory holding the SQLite index, embeddings, and cached GitHub responses. Defaults to `$XDG_DATA_HOME/github-twin`.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "github-twin": {
      "command": "uvx",
      "args": [
        "github-twin",
        "serve"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
        "GT_PATHS__DATA_DIR": "<YOUR_GT_PATHS_DATA_DIR>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "github-twin": {
      "command": "uvx",
      "args": [
        "github-twin",
        "serve"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
        "GT_PATHS__DATA_DIR": "<YOUR_GT_PATHS_DATA_DIR>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "github-twin": {
      "command": "uvx",
      "args": [
        "github-twin",
        "serve"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
        "GT_PATHS__DATA_DIR": "<YOUR_GT_PATHS_DATA_DIR>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "github-twin": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "github-twin",
        "serve"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
        "GT_PATHS__DATA_DIR": "<YOUR_GT_PATHS_DATA_DIR>"
      }
    }
  }
}

Claude Code

claude mcp add github-twin --env GITHUB_TOKEN=<YOUR_GITHUB_TOKEN> --env ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY> --env GEMINI_API_KEY=<YOUR_GEMINI_API_KEY> --env GT_PATHS__DATA_DIR=<YOUR_GT_PATHS_DATA_DIR> -- uvx github-twin serve