Skip to main content
If you have not installed Cursor, 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

Enter the command in the command line.
gbox login
This command will prompt you to enter your GBOX API key and configure your account.
3

Use GBOX CLI to configure GBOX Android MCP Server for Cursor

Set up the Model Context Protocol (MCP) server to enable communication between Cursor and GBOX.
#Using GBOX CLI
#NOTE: This command will not affect your original configuration.
gbox mcp export --merge-to cursor

#Check merging result
cursor /Users/@your-username/.cursor/mcp.json
Or copy and paste the following content into your Cursor configuration file, you’ll find the MCP configuration in ~/.cursor/mcp.json:
{
  "mcpServers": {
    "gbox-android": {
      "command": "npx",
      "args": [
        "-y",
        "@gbox.ai/mcp-server@latest"
      ]
    }
  }
}
4

Add Cursor Rule for Android Testing

Download and configure the pre-built rule file for Android app testing: Rule File LinkAdd Rule Step 1This rule file contains predefined instructions for the AI agent to effectively test Android applications using GBOX.
5

Develop and Test Your Android App

Now you can use Cursor’s Agent Mode to test your Android applications.
  1. Enable Agent Mode in Cursor
  2. Check whether the rule is enabled Add Rule Step 1
  3. Assign testing tasks to the AI agent: Assign Task
6

Work with your local Android

By default, GBOX MCP uses a cloud android VM. To connect GBOX to your own Android devices, see Register Local Devices.

​
Demo