You can run and use the AutoBot MCP server to remotely control and automate Android devices through the Model Context Protocol. This server exposes device information, control actions, app management, file operations, and more, so you can build powerful automation and testing workflows against real devices.

How to use

To connect with an MCP client, start the AutoBot MCP server and then attach your client to the running server. You will interact through a standard MCP workflow to request device information, issue touch and input commands, manage applications, transfer files, and perform system operations.

Start options you can use from your project directory include the following two approaches. Each approach runs the MCP server in the local process and allows your MCP client to connect via the configured runtime.

Option A: start via the standard runtime command using the built-in MCP server entry point.

Option B: start by running the main Python script directly through the runtime.

How to install

Prerequisites you need before installing the MCP server:

• Python 3.12 or newer

• uv, the Python package manager used to run MCP servers

• An Android device that is reachable from your development machine and can run the AutoBot HTTP service

Step by step install and run workflow:

1. Clone the project repository

git clone https://github.com/yourusername/autobot-mcp.git
cd autobot-mcp

2. Install dependencies using uv

uv sync

3. Create and configure the device connection file from the example

cp config.yaml.example config.yaml

Edit config.yaml to include your device information, for example:

device: ip: "192.168.1.100" # replace with your device IP port: 18080 # replace with your device port

## Run the MCP server

You can start the MCP server in one of these ways. Choose the method that fits your workflow.

Option 1: Use the autobot-mcp command

uv run autobot-mcp

Option 2: Run the Python script directly under the runtime

uv run python main.py

Option 3: Activate a virtual environment and start from there

Windows

.venv\Scripts\activate

Linux/Mac

source .venv/bin/activate

autobot-mcp

or

python main.py

## Available tools

### get\_packages

Return the list of all installed applications on the device.

### get\_device\_info

Fetch detailed device information including hardware, system, memory, and storage.

### get\_screen\_info

Retrieve current screen information such as resolution and density.

### get\_screenshot

Capture and return a screenshot of the device display.

### get\_uilayout

Obtain the current UI layout in JSON/XML format.

### hello

Test server connectivity and basic responsiveness.

### click

Click on the screen at specified coordinates (percent or absolute).

### long\_click

Perform a long press at given coordinates.

### swipe

Execute a swipe from one point to another with duration.

### input\_text

Type text into the focused input field, supporting multiple languages.

### press\_key

Simulate a hardware or software key press.

### gesture

Perform a single-finger gesture defined by points and timing.

### gestures

Execute multi-finger gesture sequences.

### start\_app

Launch the specified application by package name.

### stop\_app

Terminate the specified application.

### get\_package\_action\_intents

Query app action intents for a given package.

### clear\_app\_data

Clear all data for the specified application.

### get\_contacts

Manage contacts (add, delete, query) on the device.

### send\_sms

Send an SMS message to a number.

### call\_phone

Initiate a phone call to a number.

### get\_clipboard\_text

Retrieve the current clipboard contents.

### set\_clipboard\_text

Set the clipboard to a given text.

### list\_files

List files in a directory on the device.

### delete\_file

Delete a file at the given path.

### get\_file\_url

Get a downloadable URL for a file path.

### execute\_adb\_shell\_command

Run an arbitrary ADB shell command on the device.

### turn\_screen\_on

Turn the device screen on.

### turn\_screen\_off

Turn the device screen off.

### start\_screen\_recording

Begin screen recording with an optional limit.

### stop\_screen\_recording

Stop the ongoing screen recording.