MCP tools to enable agents to interact with mobile devices for mobile app development.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add mobile-dev-agent-tools --env ADB_PATH='<ADB_PATH>' --env XCRUN_PATH='<XCRUN_PATH>' --env IDB_PATH='<IDB_PATH>' -- npx --yes mobile-debug-mcp server~/.codex/config.toml
[mcp_servers.mobile-dev-agent-tools]
command = "npx"
args = ["--yes", "mobile-debug-mcp", "server"]
env = { ADB_PATH = "<ADB_PATH>", XCRUN_PATH = "<XCRUN_PATH>", IDB_PATH = "<IDB_PATH>" }
# codex mcp add mobile-dev-agent-tools --env ADB_PATH='<ADB_PATH>' --env XCRUN_PATH='<XCRUN_PATH>' --env IDB_PATH='<IDB_PATH>' -- npx --yes mobile-debug-mcp server~/.cursor/mcp.json
{
"mcpServers": {
"mobile-dev-agent-tools": {
"command": "npx",
"args": [
"--yes",
"mobile-debug-mcp",
"server"
],
"env": {
"ADB_PATH": "<ADB_PATH>",
"XCRUN_PATH": "<XCRUN_PATH>",
"IDB_PATH": "<IDB_PATH>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"mobile-dev-agent-tools": {
"type": "stdio",
"command": "npx",
"args": [
"--yes",
"mobile-debug-mcp",
"server"
],
"env": {
"ADB_PATH": "<ADB_PATH>",
"XCRUN_PATH": "<XCRUN_PATH>",
"IDB_PATH": "<IDB_PATH>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"mobile-dev-agent-tools": {
"command": "npx",
"args": [
"--yes",
"mobile-debug-mcp",
"server"
],
"env": {
"ADB_PATH": "<ADB_PATH>",
"XCRUN_PATH": "<XCRUN_PATH>",
"IDB_PATH": "<IDB_PATH>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"mobile-dev-agent-tools": {
"command": "npx",
"args": [
"--yes",
"mobile-debug-mcp",
"server"
],
"env": {
"ADB_PATH": "<ADB_PATH>",
"XCRUN_PATH": "<XCRUN_PATH>",
"IDB_PATH": "<IDB_PATH>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"mobile-dev-agent-tools": {
"command": "npx",
"args": [
"--yes",
"mobile-debug-mcp",
"server"
],
"env": {
"ADB_PATH": "<ADB_PATH>",
"XCRUN_PATH": "<XCRUN_PATH>",
"IDB_PATH": "<IDB_PATH>"
}
}
}
}Environment variables
ADB_PATHXCRUN_PATHIDB_PATH
Replace the placeholders with your own credentials and keep them out of version control.