Skip to main content
Glama
gitwhy-cli

gitwhy-mcp

by gitwhy-cli
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Hybrid

GitWhy MCP Server

The shared AI context engine for git — save, search, and share the reasoning behind code changes.

GitWhy captures the why behind every commit: reasoning, decisions, and trade-offs. This MCP server makes GitWhy's tools available to AI coding agents like Claude, Cursor, Windsurf, and VS Code Copilot.

Install

npm (recommended for MCP clients)

npm install -g gitwhy-mcp

Homebrew (macOS/Linux)

brew install gitwhy-cli/tap/git-why

Scoop (Windows)

scoop bucket add gitwhy https://github.com/quanng28/gitwhy-scoop-bucket
scoop install git-why

Related MCP server: Selvedge

MCP Configuration

Claude Desktop / Claude Code

Add to your MCP config (~/.claude/settings.json or Claude Desktop settings):

{
  "mcpServers": {
    "gitwhy": {
      "command": "gitwhy-mcp",
      "args": []
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "gitwhy": {
      "command": "npx",
      "args": ["-y", "gitwhy-mcp"]
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "gitwhy": {
      "command": "npx",
      "args": ["-y", "gitwhy-mcp"]
    }
  }
}

Tools

Tool

Description

gitwhy_save

Save development context (reasoning, decisions, trade-offs) for the current session

gitwhy_get

Retrieve a saved context by its ID

gitwhy_search

Search saved contexts by keyword or natural language query

gitwhy_list

Browse saved contexts by domain/topic hierarchy

gitwhy_status

Check setup state, pending commits, and sync status

gitwhy_sync

Upload local contexts to the cloud (private)

gitwhy_publish

Share synced contexts with your team

gitwhy_post_pr

Post context summary as a GitHub PR comment

Authentication

For cloud features (sync, publish, PR comments), you need a GitWhy API key:

  1. Sign up at app.gitwhy.dev

  2. Get your API key at app.gitwhy.dev/dashboard/api-keys

  3. For local CLI: run git why setup to authenticate

  4. For remote (Smithery/Glama): paste your API key when prompted

Links

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Selvedge

    masondelan
    A
    license
    A
    quality
    A
    maintenance
    Change tracking for AI-era codebases. AI agents call it to log structured change events (entity + diff + reasoning) before the session ends, then query history with diff, blame, history, changeset, and search. Captures the intent that would otherwise evaporate.
    8
    433 PyPI
    23
    MIT

  • Projectmem

    riponcm
    A
    license
    A
    quality
    A
    maintenance
    Local-first memory layer for AI coding agents — captures issues, attempts, fixes, and decisions, and warns at git commit before you repeat a mistake.
    17
    823
    MIT