homebrew-mcp

Homebrew MCP Server — manage packages, casks, taps, and services through Claude on macOS.

macOS only — requires Homebrew to be installed.

19 tools for searching, installing, upgrading, and managing Homebrew packages, casks, taps, and background services — all through natural language in Claude.

Tools

Search & Info (5)

Package Management (5)

Taps (3)

Services (4)

System (2)

Setup

Requirements

• macOS with Homebrew installed
• Python 3.10+
• uv package manager

Install Homebrew (if needed)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Install homebrew-mcp

pip install homebrew-mcp
# or with uv:
uv add homebrew-mcp

Add to Claude Code

claude mcp add homebrew -- uvx homebrew-mcp

Or manually in your Claude config (~/.claude/claude_desktop_config.json):

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

Usage Examples

Install Docker Desktop:     install("docker", cask=True)
Install PostgreSQL:         install("postgresql")
Start PostgreSQL service:   start_service("postgresql")
List running services:      list_services()
Check for updates:          list_outdated()
Upgrade everything:         upgrade_all()
Add a tap:                  tap("homebrew/cask-fonts")
Run diagnostics:            doctor()

Troubleshooting

"brew: command not found": Install Homebrew first: brew.sh

Permission errors during install: Some casks require admin password. Claude will show the brew output including any prompts.

Service won't start: Check doctor() for system issues. Ensure the formula is installed first.

Requirements

• macOS
• Homebrew installed
• Python 3.10+

License

MIT — Hitesh Gupta