# github-twin MCP server

> Provides personal RAG over GitHub history, indexing commits and reviews to surface coding style and past feedback to AI agents.

- Repository: https://github.com/ChristopherDavenport/github-twin
- Page: https://hostedmcp.org/servers/christopherdavenport/github-twin
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.0.17

## Install

### Claude Code

```sh
claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' --env 'GEMINI_API_KEY=<YOUR_GEMINI_API_KEY>' --env 'GITHUB_TOKEN=<YOUR_GITHUB_TOKEN>' github-twin -- uvx github-twin
```

### Cursor (`~/.cursor/mcp.json`)

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

### VS Code (`.vscode/mcp.json`)

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

### VS Code CLI

```sh
code --add-mcp '{"name":"github-twin","type":"stdio","command":"uvx","args":["github-twin"],"env":{"ANTHROPIC_API_KEY":"<YOUR_ANTHROPIC_API_KEY>","GEMINI_API_KEY":"<YOUR_GEMINI_API_KEY>","GITHUB_TOKEN":"<YOUR_GITHUB_TOKEN>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

```sh
codex mcp add github-twin --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' --env 'GEMINI_API_KEY=<YOUR_GEMINI_API_KEY>' --env 'GITHUB_TOKEN=<YOUR_GITHUB_TOKEN>' -- uvx github-twin
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.github-twin]
command = "uvx"
args = ["github-twin"]

[mcp_servers.github-twin.env]
ANTHROPIC_API_KEY = "<YOUR_ANTHROPIC_API_KEY>"
GEMINI_API_KEY = "<YOUR_GEMINI_API_KEY>"
GITHUB_TOKEN = "<YOUR_GITHUB_TOKEN>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' -e 'GEMINI_API_KEY=<YOUR_GEMINI_API_KEY>' -e 'GITHUB_TOKEN=<YOUR_GITHUB_TOKEN>' github-twin uvx -- github-twin
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `ANTHROPIC_API_KEY` | no | yes | Optional. Enables the Claude backend for `gt summarize`, `gt distill`, and `gt eval`. Defaults to local Ollama when unset. |
| `GEMINI_API_KEY` | no | yes | Optional. Enables the Gemini backend for embedding and the LLM seam. Vertex AI ADC via `GT_GEMINI_PROJECT` is also supported. |
| `GITHUB_TOKEN` | no | yes | 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`). |
| `GT_PATHS__DATA_DIR` | no | no | Optional. Override the on-disk data directory holding the SQLite index, embeddings, and cached GitHub responses. Defaults to `$XDG_DATA_HOME/github-twin`. |
| `OTEL_EXPORTER_OTLP_ENDPOINT` | no | no |  |
| `OTEL_SERVICE_NAME` | no | no |  |

## FAQ

### Does my code stay private?

Yes, embeddings are computed locally using Ollama or sentence-transformers, so your code stays on your machine.

### How do I authenticate with GitHub?

You can use the OAuth device flow, an existing GitHub CLI session, or a GITHUB_TOKEN environment variable.
