MCP Mobile Server

How to use

You use MCP Mobile Server with an MCP client like Claude Desktop to automate and orchestrate mobile development tasks. Start a development session, let the system select the best device, and run automated environment setup, builds, tests, and deployments with natural language commands.

To begin a typical workflow, install the server, start a session for your project, and then issue high-level requests such as creating a new app, running tests, or building release artifacts. The system will coordinate with Flutter, Android, and iOS tools, manage devices, and keep your environment in a healthy state.

Key startup and workflow steps you will perform include health checks to validate your environment, automated Flutter setup, and starting a coding session that hot-reloads as you work. You can also request automated issue fixes, multi-device testing, and one-command deployment pipelines.

How to install

Prerequisites you need before installing MCP Mobile Server are Node.js 18.0 or newer, a package manager such as npm or yarn, and at least one mobile development toolset available (Flutter, Android SDK, or Xcode). If you plan iOS development, you should be on macOS with Xcode installed.

Install MCP Mobile Server globally so you can run it from any project directory.

# Install globally
npm install -g @cristianoaredes/mcp-mobile-server

# Or run directly with npx
npx @cristianoaredes/mcp-mobile-server

Configuration and usage notes

Integrate MCP Mobile Server with Claude Desktop by adding an MCP server entry to the Claude configuration so you can start sessions directly from the chat interface.

{
  "mcpServers": {
    "mobile-dev": {
      "command": "npx",
      "args": ["@cristianoaredes/mcp-mobile-server"]
    }
  }
}

First steps in practice

Check your environment health to ensure all required tools are available.

mcp-mobile-server health_check

Set up Flutter automatically to prepare your development environment.

mcp-mobile-server flutter_setup_environment --action=full

Start a development session for your Flutter project, specifying the working directory of your project.

mcp-mobile-server flutter_dev_session --cwd=/path/to/project

flutter_dev_session

Complete dev environment with hot reload and best device auto-selection

flutter_test_suite

Run all tests with coverage analysis and CI/CD integration

flutter_release_build

Create multi-platform release builds for distribution

mobile_device_manager

Intelligent orchestration of devices and automatic device selection

flutter_fix_common_issues

Auto-fix common problems and resolve build errors automatically

health_check

System diagnostics and environment validation

flutter_doctor

Flutter environment verification

flutter_version

Flutter SDK version management

flutter_list_devices

Discover connected devices across platforms

android_list_devices

List Android devices and emulators

native_run_list_devices

Universal device listing across platforms

native_run_install_app

Cross-platform app installation to devices/emulators

ios_list_simulators

Discover iOS simulators available on the system

android_list_emulators

List and manage Android emulators (AVD)

android_create_avd

Create new Android Virtual Devices for testing

android_start_emulator

Launch and manage Android emulators

android_stop_emulator

Stop and clean up Android emulators

ios_shutdown_simulator

Shut down and reset iOS simulators

flutter_launch_emulator

Quickly start a Flutter-compatible emulator

flutter_run

Run Flutter apps with hot reload enabled

flutter_build

Produce production-ready builds for deployment

flutter_test

Execute tests for Flutter projects

flutter_clean

Clear caches and clean build artifacts

flutter_pub_get

Fetch Dart/Flutter dependencies

android_install_apk

Deploy APKs to devices or emulators

android_logcat

Capture device log output for debugging

android_screenshot

Capture screenshots from devices for debugging

ios_boot_simulator

Start an iOS simulator for testing

ios_take_screenshot

Capture screenshots from iOS simulator

flutter_performance_profile

Analyze and profile Flutter app performance

flutter_deploy_pipeline

Coordinate full deployment pipelines across platforms

android_full_debug

Complete debugging workflow for Android apps

ios_simulator_manager

Orchestrate iOS simulators for testing

flutter_inspector_session

Widget inspection session for Flutter apps