Prerequisites & Installation

Ensuring you have the necessary requirements and access configured for a smooth installation experience.

Attention

Claude Desktop Requirements

Claude Desktop runs in an isolated environment that cannot access user-install programs. This means uv must be installed via Homebrew for proper access: brew install uv.

Installing uv via pip, curl or other methods will place it in paths like ~/.local/bin that Claude Desktop cannot access, resulting in spawn uv ENOENT errors.

Why does this matter? Glad you asked! Claude Desktop’s security model isolates it from user PATH locations. Only system-wide installations (like those from Homebrew to /opt/homebrew/bin or /usr/local/bin) are accessible.

System Requirements

Python 3.13+

JamfMCP requires modern Python features available in 3.13 or higher

uv Package Manager

Modern, fast Python package management

Jamf Pro Server

Cloud or on-premise instance with API access enabled

MCP Client

Claude Desktop, Cursor, or other MCP-compatible clients

Installing uv

# Install Homebrew if you don't have it
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install uv via Homebrew
brew install uv

# Verify installation location (should be /opt/homebrew/bin/uv or /usr/local/bin/uv)
which uv

# Install to system location
curl -LsSf https://astral.sh/uv/install.sh | sudo sh

# Or if you have Homebrew on Linux
brew install uv

# Verify installation
which uv
(Optional) Verify installation

After installing uv, verify it’s accessible:

# Check version
uv --version

# Check installation path
which uv  # macOS/Linux

# For Claude Desktop users - ensure path is NOT in home directory
# Good: /opt/homebrew/bin/uv, /usr/local/bin/uv
# Bad: ~/.local/bin/uv, ~/bin/uv

See also