Install Berry

Pick your method. All roads lead to berry init.

Requirements

  • Python 3.10+ (for pip/pipx installs)
  • Berry authentication (recommended: berry auth login)
  • MCP-capable client — Cursor, Claude Code, Codex, or Gemini CLI

macOS

Homebrew

Official

Install via Homebrew cask. Recommended for most users.

brew install --cask berry-mcp

Upgrades:

brew upgrade --cask berry-mcp

Package Installer (.pkg)

Official

Download the signed and notarized .pkg from GitHub Releases:

Full macOS guide: strawberry.hassana.io/docs/install/macos

curl -LO https://github.com/leochlon/berry/releases/download/v1.0.1/berry-1.0.1-macos-arm64.pkg sudo installer -pkg berry-1.0.1-macos-arm64.pkg -target /
Note

The .pkg is signed and notarized for Gatekeeper. If you see a warning, right-click and select Open.

pip / pipx

From Source

Clone and install from the repository:

git clone https://github.com/hassana-labs/berry.git cd berry pipx install .

Or with pip:

pip install .

Linux

pip / pipx

From Source

Clone and install from the repository:

git clone https://github.com/hassana-labs/berry.git cd berry pipx install .

Or with pip:

pip install .
Note

Requires Python 3.10+. Check with python3 --version.

Windows

Windows Installer (.exe)

Official

Download the latest .exe from GitHub Releases, then run it.

Full Windows installer guide

pip / pipx

From Source

Clone and install from the repository:

git clone https://github.com/hassana-labs/berry.git cd berry pipx install .

Or with pip:

pip install .
Warning

Windows support is experimental. Some features may not work as expected.

Quick Setup

After installing, run the quickstart command to configure Berry for your MCP client:

berry quickstart

Or get manual instructions:

berry instructions

Client Setup

Configure Berry for your MCP client:

Cursor

MCP Client

Configure .cursor/mcp.json for Cursor IDE

Claude Code

MCP Client

Configure .mcp.json for Claude Code CLI

Codex

MCP Client

Configure .codex/config.toml for OpenAI Codex

Gemini CLI

MCP Client

Configure .gemini/settings.json for Gemini

After Installing

Regardless of install method, you'll need to:

  1. Authenticate (recommended):
    berry auth login

    Headless/CI: berry auth set (or berry auth set --stdin).

  2. Initialize your repo:
    berry init
  3. Reload MCP servers in your client