gitorg-mcp

An MCP (Model Context Protocol) server that exposes GitHub organization data to AI assistants. This wraps the functionality from gitorg as MCP tools over stdio transport.

Tools

All tools are annotated with readOnlyHint: true — this server only reads data from GitHub.

Setup

1. Install Rust

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

2. Build

git clone https://github.com/DavidLiedle/gitorg-mcp.git
cd gitorg-mcp
cargo build --release

The binary will be at target/release/gitorg-mcp.

3. Configure GitHub Token

Option A: Environment variable

export GITHUB_TOKEN=ghp_yourtoken

Option B: Config file (shared with gitorg)

Create ~/.config/gitorg/config.toml:

[auth]
token = "ghp_yourtoken"

[defaults]
orgs = ["myorg", "otherorg"]  # optional: limit to specific orgs

The token needs read:org and repo scopes. Create one at github.com/settings/tokens.

MCP Configuration

Claude Code

Add to your Claude Code MCP settings (.claude/settings.json or via claude mcp add):

claude mcp add gitorg-mcp /path/to/gitorg-mcp/target/release/gitorg-mcp

Or with a GitHub token passed as an environment variable:

claude mcp add gitorg-mcp -e GITHUB_TOKEN=ghp_yourtoken -- /path/to/gitorg-mcp/target/release/gitorg-mcp

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "gitorg-mcp": {
      "command": "/path/to/gitorg-mcp/target/release/gitorg-mcp",
      "env": {
        "GITHUB_TOKEN": "ghp_yourtoken"
      }
    }
  }
}

Tool Details

list_orgs

No parameters. Returns all organizations the authenticated user belongs to.

list_repos

find_stale

list_issues

get_stats

get_overview

Organization Resolution

When no org parameter is provided, the server resolves organizations in this order:

1. defaults.orgs from ~/.config/gitorg/config.toml (if set)
2. All organizations the authenticated user belongs to (via GitHub API)

License

MIT