gitpal-mcp

MCP server for GitPal — use AI-powered git automation from any MCP-compatible assistant.

---

What is this?

An MCP (Model Context Protocol) server that exposes GitPal CLI commands as tools. This lets Claude Code, OpenCode, Claude Desktop, or any MCP client use GitPal directly.

Prerequisites

• GitPal CLI installed and available as gp in your PATH
• Node.js 18+ or Bun

Quick Start

Claude Code

Add to ~/.claude/settings.local.json (or project-level .claude/settings.local.json):

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

OpenCode

Add to ~/.config/opencode/opencode.json:

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

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

With Bun (faster startup)

Replace npx with bunx in any of the above configs:

{
  "command": "bunx",
  "args": ["gitpal-mcp"]
}

Available Tools

Tool	Description
gp_push	Commit all changes and push to GitHub with AI-generated commit message
gp_status	Show status of all watched GitPal projects
gp_log	Show recent git commits (supports JSON output, inline diffs)
gp_diff	Show uncommitted changes in a project
gp_snapshot	Commit locally without pushing to GitHub
gp_undo	Restore a previous git state (snapshots current state first)
gp_context	Show project context cheat sheet (.gp/context.md)
gp_doctor	Run system health check (with optional auto-fix)
gp_digest	Generate the GitPal Gazette daily digest
gp_readme	Regenerate README.md and update GitHub metadata
gp_blame	Show who changed each line in a file
gp_sync	Pull latest changes from GitHub
gp_clean	Remove build artifacts and untracked files
gp_recent	Show all projects sorted by last activity
gp_open	Open project on GitHub in browser

Most tools accept an optional path parameter to specify which project directory to operate on. If omitted, the current working directory is used.

Development

git clone https://github.com/bb82dabn/gitpal-mcp.git
cd gitpal-mcp
bun install
bun run dev     # Run directly
bun run build   # Build to dist/index.js

License

MIT