jeannier/homebrew-mcp

Overview

A Model Context Protocol server that exposes Homebrew commands as tools for AI assistants. It lets you install, upgrade, search, and maintain macOS packages through natural language or API calls. Built in Python, it translates MCP requests into Homebrew CLI operations.

Best for

Best for
Developers who want to manage macOS packages through AI assistants or chat interfaces

Use cases

• Install a macOS package via an AI assistant
• Search for available Homebrew formulae
• Upgrade all outdated packages on a machine

How to use

Install

uv run python homebrew_mcp.py

Tools exposed

• install
• uninstall
• upgrade
• cleanup
• list
• search
• info
• outdated
• deps
• doctor
• update
• tap
• untap
• pin
• unpin
• services

Tested with

Claude Desktop, Cursor

Example client config

{\n  "mcpServers": {\n    "homebrew-mcp": {\n      "command": "uv",\n      "args": [\n        "run",\n        "--directory",\n        "/path/to/your/project/",\n        "homebrew_mcp.py"\n      ],\n      "type": "stdio"\n    }\n  }\n}

Notes

A Model Context Protocol server that exposes Homebrew commands as tools for AI assistants. It lets you install, upgrade, search, and maintain macOS packages through natural language or API calls. Built in Python, it translates MCP requests into Homebrew CLI operations.

29 stars on GitHub. Last updated 2025-06-23. Licensed MIT.

Use cases

• Install a macOS package via an AI assistant
• Search for available Homebrew formulae
• Upgrade all outdated packages on a machine

Pros

• Integrates Homebrew package management directly into MCP-compatible AI tools
• Supports common brew operations like install, upgrade, search, and list
• Lightweight, open-source Python implementation

Cons

• Requires Homebrew to be installed on the target machine
• Limited to macOS only; no Linux support
• Small community and relatively few stars may indicate limited adoption

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.