Skip to main content
If you have not installed Claude Code, please check the installation instructions before proceeding.

​
Getting Started

1

Install GBOX CLI

Install the GBOX CLI tool to manage your GBOX configuration.
# Install GBOX CLI
brew install gbox

# Update GBOX if already installed
brew update && brew upgrade gbox
2

Login and Configure GBOX

Authenticate with your GBOX account and set up the configuration.
gbox login
This command will prompt you to enter your GBOX API key and configure your account.
3

Configure the GBOX Android MCP Server for Claude Code using the GBOX CLI

Enter the command in the command line
#Using GBOX CLI

#scope param: MCP server scope for claude-code (local|project|user) (default "user")
gbox mcp export --merge-to claude-code --scope user

#Check merging result
claude mcp list
#Expected Output: gbox-android: npx -y @gbox.ai/mcp-server
4

Develop and Test Your Android App

If the installation is correct, you will see the gbox-android mcp server when you type /mcp in Claude.Claude Code Interface 1Then you can give Claude Code instructions using natural language, for example:Claude Code Interface 1Claude Code Interface 1By default, GBOX MCP uses a cloud android VM. To connect GBOX to your own Android devices, see Register Local Devices.Demo