> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gbox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Android MCP Server

> MCP server exposing GBOX Android control tools via Model Context Protocol

[![npm version](https://img.shields.io/npm/v/@gbox.ai/mcp-server.svg)](https://www.npmjs.com/package/@gbox.ai/mcp-server) [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/babelcloud/gbox/blob/HEAD/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.

```bash theme={null}
#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](https://gbox.ai/dashboard).

```json theme={null}
"gbox-android": {
  "command": "npx",
  "args": [
    "-y",
    "@gbox.ai/mcp-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](/integrations/ide/cursor), [Claude Code Guide](/integrations/ide/claude-code) and [VSCode Guide](/integrations/ide/vscode).

If you need the agents to control your local
Android devices, please check [https://docs.gbox.ai/cli/register-local-device](https://docs.gbox.ai/cli/register-local-device).