Skip to main content
MCP server exposing GBOX Android control tools via Model Context Protocol
npm version
MIT License

​
Description

This package provides an MCP (Model Context Protocol) server for controlling Android devices via GBOX tools. It exposes a set of tools and APIs for automation, device management, and integration with the GBOX ecosystem.

​
Usage

Use GBOX CLI to configure GBOX Android MCP Server for Cursor and Claude Code. 
#Using GBOX CLI to configure GBOX Android MCP Server for Cursor
gbox mcp export --merge-to cursor

#Using GBOX CLI to configure GBOX Android MCP Server for Claude Code
gbox mcp export --merge-to claude-code --scope user
Copy the following configuration into your Cursor or Claude code MCP config file:
GBOX_API_KEY needs to be obtained through GBOX Dashboard. 
"gbox-android": {
  "command": "npx",
  "args": [
    "-y",
    "@gbox.ai/mcp-android-server@latest"
  ],
  // NOTE: You can omit the 'env' section if you have successfully run 'gbox login' in cli.
  "env": {
    "GBOX_API_KEY": "gbox_xxxx",
  }
}
For detailed instructions on connecting IDE to GBOX MCP, please see the following: Cursor Guide, Claude Code Guide and VSCode Guide. If you need the agents to control your local Android devices, please check https://docs.gbox.ai/cli/register-local-device.
⌘I