Homebrew

The formula lives in the jmrplens/homebrew-tap tap and is regenerated by the release workflow on every release, from the same checksums.txt the release ships. It is a binary formula: Homebrew downloads the release asset for your platform (Apple Silicon or Intel on macOS, arm64 or x86_64 on Linux), checks it against the SHA-256 pinned in the formula, and installs it as bin/gitlab-mcp-server under its prefix. Nothing compiles, and no dependencies are pulled in.

Install

brew install jmrplens/tap/gitlab-mcp-server

The fully qualified name taps jmrplens/tap on the way, so there is no separate brew tap step. The tap is at the current release, 2.7.5, with the asset URLs and hashes of that release.

Verify

gitlab-mcp-server --version

prints gitlab-mcp-server 2.7.5 (commit: <commit>). That is also what the formula’s own test runs. brew info gitlab-mcp-server shows the installed version and the formula’s caveats, which repeat the client configuration below. The formula published for 2.7.5 still mentions AUTO_UPDATE=false and --setup in those caveats; neither exists any more, the generator no longer emits those lines, and the next release’s formula will not carry them.

Where the binary lands

Homebrew installs into its prefix: /opt/homebrew on Apple Silicon, /usr/local on Intel macOS, and /home/linuxbrew/.linuxbrew on Linux, so the command is $(brew --prefix)/bin/gitlab-mcp-server. brew --prefix prints the one in use on your machine. Clients started from the desktop rather than from a shell do not always see Homebrew’s bin directory on their PATH, which is why the formula’s caveats and the snippet below use the absolute path.

Configure your client

{
  "mcpServers": {
    "gitlab": {
      "command": "/opt/homebrew/bin/gitlab-mcp-server",
      "env": {
        "GITLAB_TOKEN": "glpat-xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Replace the command with your prefix if it is not /opt/homebrew, and add "GITLAB_URL": "https://gitlab.example.com" to env for a self-managed instance. With Claude Code the token goes in ~/.gitlab-mcp-server.env, which the server reads itself, and the registration names it nowhere: echo 'GITLAB_TOKEN=glpat-xxxx' > ~/.gitlab-mcp-server.env then claude mcp add gitlab -- gitlab-mcp-server. The per-client tabs are on the Quick Start.

Upgrade and uninstall

Homebrew manages upgrades; the binary never updates itself.

brew update
brew upgrade gitlab-mcp-server

Because the release workflow pushes the regenerated formula as part of every release, brew upgrade sees the new version as soon as the GitHub release is out. The generator now emits a livecheck block (strategy github_latest) so Homebrew’s own tooling can tell when the tap falls behind; the 2.7.5 formula predates it, and the block appears with the next release. To remove it:

brew uninstall gitlab-mcp-server
brew untap jmrplens/tap   # optional: also forget the tap

These are the standard Homebrew commands; the formula adds nothing of its own to them. Remove the gitlab entry from your client’s configuration afterwards.