How do I connect Scrcpy MCP Server to Claude?

Run `claude mcp add juancf-scrcpy-mcp -- npx -y scrcpy-mcp` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.

Is Scrcpy MCP Server free?

The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Scrcpy MCP Server do?

Scrcpy MCP Server documents 36 tools to the agent, including app_current, app_install, app_list. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Scrcpy MCP

Unclaimed

by JuanCF

MCP server for Android device control via ADB and scrcpy — gives AI agents vision and control over Android devices

Set up this server

Compare servers My Stack

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructionsEnvironment variable names (optional)

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'juancf-scrcpy-mcp' -- 'npx' '-y' 'scrcpy-mcp'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

adbandroidmcpmcp-serverscrcpyscrcpy-mcp

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

36 of 36 tools

Documented tools (36)

From project documentation. A server handshake does not verify each tool’s description or behavior.

app_current

Get the current foreground app and activity

app_install

Install an APK from the host machine

app_list

List installed packages, optionally filter by name or system/third-party

app_start

Launch an app by package name. Prefix with + to force-stop before launch.

app_stop

Force-stop an app

app_uninstall

Uninstall an app

clipboard_get

Get clipboard content. Uses scrcpy to bypass Android 10+ restrictions.

clipboard_set

Set clipboard content. Pass paste: true to also paste immediately.

collapse_panels

Collapse notification/settings panels (requires active session)

device_info

Get model, Android version, screen size, SDK level, battery

device_list

List all connected devices with serial, state, and model

drag_drop

Drag from one point to another

expand_notifications

Pull down the notification panel (requires active session)

expand_settings

Pull down the quick settings panel (requires active session)

file_list

List directory contents on the device

file_pull

Pull a file from the device to the host machine

file_push

Push a file from the host machine to the device

input_text

Type a text string into the focused field

key_event

Send a key event: HOME, BACK, ENTER, VOLUMEUP, VOLUMEDOWN, POWER, etc.

long_press

Long press at coordinates

rotate_device

Rotate the screen (requires active session)

screen_off

Turn the screen off

screen_on

Wake the device screen

screen_record_start

Start recording the screen to a file on the device

screen_record_stop

Stop recording and optionally pull the file to the host

screenshot

Capture the screen and return it as an image. ~33ms with scrcpy, ~500ms via ADB.

scroll

Scroll at a position (dx=horizontal, dy=vertical)

shell_exec

Execute an arbitrary ADB shell command and return the output

start_session

Start a scrcpy session. When active, input and screenshots use the fast path (10-50x faster).

start_video_stream

Start an HTTP MJPEG video stream and open an ffplay viewer window. Auto-starts a scrcpy session if needed.

stop_session

Stop the scrcpy session. Tools fall back to ADB.

stop_video_stream

Stop the video stream and close the viewer window.

swipe

Swipe from one point to another

tap

Tap at screen coordinates

ui_dump

Dump the full UI hierarchy as XML

ui_find_element

Find elements by text, resource ID, class name, or content description. Returns tap coordinates.

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Scrcpy MCP Server

How do I connect Scrcpy MCP Server to Claude?: Run `claude mcp add juancf-scrcpy-mcp -- npx -y scrcpy-mcp` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is Scrcpy MCP Server free?: The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Scrcpy MCP Server do?: Scrcpy MCP Server documents 36 tools to the agent, including app_current, app_install, app_list. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.