- Home
-
- Explore features
-
- Efficient task automation with API
-
- Basic automation with CLI
-
- How to use CLI commands for cloud phones
How to use CLI commands for cloud phones
Written by
( Updated on October 6th, 2026 )
Updated on October 6th, 2026
Use Multilogin CLI to create, update, start, stop, organize, transfer, and manage Android cloud phones from the command line.
To see the current commands on your device, run xcli --help on Windows or ./xcli --help on macOS/Linux.
Before you start: launch Multilogin CLI and sign in. If you are new to CLI, see “How to start working with CLI”.
Using CLI as a team member? Available commands still follow your workspace role and folder permissions.Helpjuice Success Callout Body
Step 1: launch CLI
Launch Multilogin, then open Command Prompt or Terminal, go to the CLI folder and run CLI executable:
Windows
- Go to the CLI folder:
C:/Users/%username%/mlx/deps/cli - Run
xcli.exe
macOS
- Go to the CLI folder:
/Users/%username%/mlx/deps/cli - Run
./xcli:./xcli
Linux
- Go to the CLI folder:
/Home/%username%/mlx/deps/cli - Run
./xcli:./xcli
Follow the article for more details: How to start working with CLI.
Step 2: sign in to authenticate
Sign in to authenticate your CLI session.
Paste this command: xcli login --username your username --password your password:
Windows
- Paste this prompt to sign in:
xcli login --username 'your username' --password 'your password' - Replace values of the flags (
--usernameand--password) with your email and password
macOS
- Paste this prompt to sign in:
./xcli login --username 'your username' --password 'your password' - Replace values of the flags (
--usernameand--password) with your email and password
Linux
- Paste this prompt to sign in:
./xcli login --username 'your username' --password 'your password' - Replace values of the flags (
--usernameand--password) with your email and password
Then scroll to “Mobile Profile Commands”. This section has the commands you can use for cloud phones.
Ready to run your first cloud phone commands? Start with these guides:
Cloud phone commands
Want to do something specific? Use the table below to find the right command:
| Cli command | Description | Required flags | Notes |
|
gets cloud phone limit |
N/A | |
|
gets or create cloud phone group |
N/A | Returns the cloud phone group for the current workspace. If no group exists yet, one is created automatically. |
|
gets states by country |
--country |
ISO country codes are used. For example, USA and GBR for the US and UK respectively. |
|
gets cities by state |
--state |
Use the state name returned by |
|
checks proxy configuration |
|
Set the proxy port. The default port is 1080. Choose the proxy type: socks5 or http. The default type is socks5. Set the server address next to the |
|
gets list of phone brands by Android version |
--android-version |
Set the number for the --android-version flag (e.g. 12, 13, 14, 15, 16).
|
|
gets list of cloud phones with filters |
N/A | There are additional values for filtering the search result. Use --help flag for that. |
|
creates new cloud phones |
|
Set the OS version with the For proxy, add the full proxy string, for example: socks5://user:pass@host:port You can also set extra values, like geolocation, brand, and model. Use the |
|
updates cloud phones |
|
Use the cloud phone ID with the You can also edit proxy, notes, and tags. Use the |
|
delete cloud phones by IDs |
--ids |
Separate the list of cloud phone IDs with comma. For example: "1,2,3" |
|
gets cloud phone statuses |
--ids |
Separate the list of cloud phone IDs with commas. For example: "1,2,3" |
|
assign tags to cloud phones |
|
You can add up to 10 tags. |
|
removes tags from cloud phones |
|
|
|
shutdowns cloud phones |
--ids |
Separate the list of cloud phone IDs with commas. For example: “1,2,3” |
|
launches cloud phones |
--ids |
Separate the list of cloud phone IDs with comma. For example: “1,2,3” |
|
get list of available applications for cloud phones |
N/A | You can use extra values to filter the results. Use the flag --help to see them. |
|
batches install applications for a group of phones |
|
--id is the application ID. --version_id is the app version ID. You can get both values with the mobile-profiles-app-list command. |
|
starts cloud phone proxy call (launch phone without GUI) |
--ids |
Separate list of cloud phone IDs with comma. For example: “1,2,3” |
|
stops cloud phone proxy call (stops phone without GUI) |
--ids |
Separate list of cloud phone IDs with comma. For example: “1,2,3” |
|
downloads Excel template for import |
N/A | Set a custom export path with the --output flag. By default, files are saved in /mlx/deps/cli/
|
|
validates cloud phone import file |
--file |
--file sets the path to the Excel file you want to validate.
|
|
exports cloud phones to Excel file |
--ids |
Set a custom export path with the
|
|
lists uploaded cloud phone files |
--page |
Set the page number. Page 1 is used by default. You can use extra values to filter the results. Use the |
|
uploads a file to cloud phone drive |
|
--file sets the path to the file. Use --help to see supported file types.
|
|
deletes files from cloud phone drive by IDs |
--ids |
Separate list of file IDs with commas. For example: “1,2,3”. You can get file IDs from |
|
assigns tags to cloud phone files |
|
You can add up to 10 tags. |
|
unassigns tags from cloud phone files |
|
You can add up to 10 tags. |
|
transfers cloud phone to another user |
|
Separate list of file IDs with commas. For example: “1,2,3”. You can transfer up to 200 profiles at once.
|
mobile-profiles-adb-set |
Set ADB state on running cloud phone | --ids |
You should either set --enable or --disable flag to manage ADB functionality. |
mobile-profiles-adb-info |
Get ADB connection details for cloud phones | --ids |
Returns the info such as the cloud phone state, IP, port and password (pwd). They are important for connecting ADB in the terminal. |
