Skip to main content
Glama
Sign In
gitwhy-mcp

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: local-brain-mcp

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Selvedge

      masondelan
      A
      license
      A
      quality
      B
      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
      62 PyPI
      26
      MIT

    • beadless

      KuraPiee
      A
      license
      Not graded
      quality
      C
      maintenance
      Provides AI coding agents with git-native persistent memory and a dependency-aware task graph, letting them record and fuzzy-recall architectural decisions, lessons, and gotchas while creating, claiming, and completing tasks that auto-unblock downstream work. Stores everything as plain JSON and Markdown committed inside the repository, so context stays branch-aware, team-shared, and reviewable in pull requests.
      7 npm
      MIT

    • lore

      razamalik7
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI coding agents to search, retrieve, save, and sync encrypted Git-native context, transcripts, and takeaways across devices and contributors. It provides local full-text search, session access, and status tools while keeping context private on public repositories and avoiding token bloat.
      825 npm
      MIT