@meta-quest/metavr

Meta VR CLI (metavr) - CLI and MCP server for Meta Quest development, device management, performance tracing, and AI-assisted workflows

Installation

npm install -g @meta-quest/metavr

Or use directly with npx (the bare metavr name is the short, canonical form):

npx metavr --help

Commands

The CLI is invoked as metavr (the legacy hzdb command keeps working via the @meta-quest/hzdb compatibility package).

| Command | Description | |---------|-------------| | metavr device | Manage connected Meta Quest devices (list, info, connect, battery) | | metavr app | Manage applications (install, uninstall, launch, stop, info) | | metavr capture | Capture screenshots and screen recordings from the device | | metavr files | Manage files on the device (ls, push, pull, rm, mkdir) | | metavr log | View device logs (logcat) | | metavr shell | Run shell commands on the device | | metavr perf | Performance analysis and Perfetto trace tools | | metavr docs | Search and fetch Meta Quest developer documentation | | metavr asset | Search Meta's 3D asset library for models | | metavr adb | Low-level ADB-compatible commands | | metavr mcp | Built-in MCP server for AI assistant integration |

MCP Server

metavr includes a built-in Model Context Protocol (MCP) server with 40+ tools for device management, app control, file operations, documentation search, performance tracing, and more. This lets AI coding assistants interact directly with your Meta Quest device.

Install the MCP server into your AI tool

# Claude Code
metavr mcp install claude-code

# Claude Desktop
metavr mcp install claude-desktop

# Cursor
metavr mcp install cursor

# VS Code / VS Code Insiders
metavr mcp install vscode
metavr mcp install vscode-insiders

# Windsurf
metavr mcp install windsurf

# Zed
metavr mcp install zed

# Android Studio (Gemini)
metavr mcp install android-studio

# Gemini CLI
metavr mcp install gemini-cli

# OpenAI Codex CLI
metavr mcp install codex

# LM Studio
metavr mcp install lm-studio

# OpenCode
metavr mcp install open-code

# Google Antigravity (Gemini)
metavr mcp install antigravity

# Generic project-local config
metavr mcp install project

Supported Platforms

• darwin-arm64
• darwin-x64
• win32-x64

The binary for your platform is downloaded on first run from Meta's CDN.