Mobile MCP is a Model Context Protocol server that enables mobile automation and development through a platform-agnostic interface for iOS and Android. It allows AI agents and LLMs to interact with mobile applications using accessibility snapshots or coordinate-based interactions based on screenshots, eliminating the need for separate iOS or Android knowledge.
Before installing Mobile MCP, ensure you have the following:
You can install Mobile MCP using npm. The standard configuration works with most MCP tools:
{
"mcpServers": {
"mobile-mcp": {
"command": "npx",
"args": ["-y", "@mobilenext/mobile-mcp@latest"]
}
}
}
Use the Claude Code CLI to add the Mobile MCP server:
claude mcp add mobile-mcp -- npx -y @mobilenext/mobile-mcp@latest
Use the Gemini CLI to add the Mobile MCP server:
gemini mcp add mobile-mcp npx -y @mobilenext/mobile-mcp@latest
Go to Cursor Settings → MCP → Add new MCP Server. Name it to your liking, use command type with the command npx -y @mobilenext/mobile-mcp@latest. You can also verify config or add command line arguments via clicking Edit.
Go to Advanced settings → Extensions → Add custom extension. Name it to your liking, use type STDIO, and set the command to npx -y @mobilenext/mobile-mcp@latest. Click "Add Extension".
Open Qodo Gen chat panel in VSCode or IntelliJ → Connect more tools → + Add new MCP → Paste the standard config. Click Save.
Mobile MCP can connect to:
When you don't have a real device connected, you can use simulators/emulators in the background:
Check available simulators:
xcrun simctl list
Boot a simulator:
xcrun simctl boot "iPhone 16"
After adding the MCP server to your IDE/Client, instruct your AI assistant to use the available tools. Be descriptive and straight to the point in your prompts.
Find the video called "Beginner Recipe for Tonkotsu Ramen" by Way of Ramen, click on like video, after liking write a comment "this was delicious, will make it next Friday", share the video with the first contact in your whatsapp list.
Find and Download a free "Pomodoro" app that has more than 1k stars. Launch the app, register with my email, after registration find how to start a pomodoro timer. When the pomodoro timer started, go back to the app store and rate the app 5 stars, and leave a comment how useful the app is.
Open Substack website, search for "Latest trends in AI automation 2025", open the first article, highlight the section titled "Emerging AI trends", and save article to reading list for later review, comment a random paragraph summary.
Open ClassPass, search for yoga classes tomorrow morning within 2 miles, book the highest-rated class at 7 AM, confirm reservation, setup a timer for the booked slot in the phone
Open Eventbrite, search for AI startup meetup events happening this weekend in "Austin, TX", select the most popular one, register and RSVP yes to the event, setup a calendar event as a reminder.
Open Weather app, check tomorrow's weather forecast for "Berlin", and send the summary via Whatsapp/Telegram/Slack to contact "Lauren Trown", thumbs up their response.
Open Zoom app, schedule a meeting titled "AI Hackathon" for tomorrow at 10AM with a duration of 1 hour, copy the invitation link, and send it via Gmail to contacts "[email protected]".
For more detailed documentation, visit the Mobile MCP Wiki.
To add this MCP server to Claude Code, run this command in your terminal:
claude mcp add-json "mobile-mcp" '{"command":"npx","args":["-y","@mobilenext/mobile-mcp@latest"]}'See the official Claude Code MCP documentation for more details.
There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.
If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.
To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".
When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:
{
"mcpServers": {
"mobile-mcp": {
"command": "npx",
"args": [
"-y",
"@mobilenext/mobile-mcp@latest"
]
}
}
}To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.
Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.
The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.
You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.
To add this MCP server to Claude Desktop:
1. Find your configuration file:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.config/Claude/claude_desktop_config.json2. Add this to your configuration file:
{
"mcpServers": {
"mobile-mcp": {
"command": "npx",
"args": [
"-y",
"@mobilenext/mobile-mcp@latest"
]
}
}
}3. Restart Claude Desktop for the changes to take effect