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

Tool	Description
list_orgs	List the user's GitHub organizations
list_repos	List repos across orgs with optional org filter and sort (stars/activity/name/staleness)
find_stale	Find repos with no recent pushes (default: 60 days threshold)
list_issues	List open issues across orgs (excludes PRs)
get_stats	Aggregate statistics: total repos, stars, forks, issues, top languages
get_overview	Full dashboard: stats + recently active repos + stale repos + recent issues

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

Parameter	Type	Description
org	string (optional)	Filter to a specific organization
sort	string (optional)	Sort order: activity (default), stars, name, staleness

find_stale

Parameter	Type	Description
days	number (optional)	Days without a push to consider stale (default: 60)
org	string (optional)	Filter to a specific organization

list_issues

Parameter	Type	Description
org	string (optional)	Filter to a specific organization

get_stats

Parameter	Type	Description
org	string (optional)	Filter to a specific organization

get_overview

Parameter	Type	Description
org	string (optional)	Filter to a specific organization
days	number (optional)	Days threshold for stale repos (default: 60)

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