Homebrew MCP Server

Interact with Homebrew (the package manager for macOS and Linux) using natural language commands.

Local serverstdioPython

What is the Homebrew MCP Server?

Homebrew MCP lets Claude, Cursor and other MCP clients work with Homebrew MCP directly. Interact with Homebrew (the package manager for macOS and Linux) using natural language commands.

What Homebrew MCP does

A Model Context Protocol (MCP) server for Homebrew package management on macOS, designed for seamless integration with Claude Desktop and other MCP-compatible clients.

Key capabilities

  • Exposes Homebrew commands as MCP tools. The supported commands are grouped by function:
  • Package Management: — install, uninstall, upgrade, cleanup
  • Information & Discovery: — list, search, info, outdated, deps
  • System Health & Updates: — doctor, update
  • Tap & Source Management: — tap, untap
  • Version Management: — pin, unpin
  • Service Management: — services
  • Runs real brew commands via subprocess (requires Homebrew on macOS)

Practical notes

  • Written in Python.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
homebrew_mcp.pyMain MCP server script.
test_claude_homebrew_mcp.pyInteractive Claude integration test script.
mcp.jsonExample configuration for Cursor.
requirements.txtPython project dependencies.
homebrew_mcp.logLog file for the MCP server.

How to install the Homebrew MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

  • “Use Homebrew MCP to Language.”
  • “Use Homebrew MCP to MCP.”
  • “Use Homebrew MCP to homebrew mcp.py.”

Frequently asked questions

Interact with Homebrew (the package manager for macOS and Linux) using natural language commands. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.