Developer Tools

Local iOS MCP Server

Connect your account, then chat with AI to run tools.

Drive a local iOS Simulator (or USB-attached device) through the MCPBundles desktop proxy. Tap, swipe, type, take screenshots, inspect UI hierarchies, open Safari URLs, and launch apps using a developer-machine Appium 2.x server.

Managed
20 tools
Agent guide included

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for Local iOS — workflow patterns, data models, and gotchas for your AI agent.

Local iOS

Automate a macOS-resident iOS Simulator via Appium XCUITest. The MCPBundles desktop proxy forwards backend traffic to 127.0.0.1:4723, so the backend can drive the simulator without exposing Appium publicly.

Data Model

  • Session — one Appium WebDriver session per user.
  • Elements — locate via accessibility id / xpath / iOS predicate / iOS class chain; tap or type by element id.
  • Gestures — coordinate-based tap and swipe (W3C Actions). No hardware buttons; use swipes for navigation.
  • Browser — open a Safari WebDriver session by passing browser=true to local_ios_create_session.

Gotchas

  • Boot the simulator BEFORE calling local_ios_create_session.
  • Safari is required for local_ios_navigate_url; native sessions cannot open arbitrary URLs.

Tools in this Server (20)

Local Ios Create Session

Start a local Appium iOS session through the MCPBundles desktop proxy. Requires a booted simulator and a running local Appium 2.x server. Returns the ...

Local Ios Find Element

Find a UI element on the active local iOS session and return its WebDriver element id and visible text.

Local Ios Get Contexts

List the Appium contexts on the active local iOS session. ``NATIVE_APP`` is the native UI tree; ``WEBVIEW_<package>`` (Android) or ``WEBVIEW_<id>`` (i...

Local Ios Get Page Source

Return the current UI hierarchy from the active local iOS session (XML for native apps, HTML for browser sessions). Use this before tapping or typing ...

Local Ios Get Webview Html

Capture the WebView HTML on the active local iOS session. Switches to the first WEBVIEW context (auto-detected) and returns ``document.documentElement...

Local Ios Get Window Size

Return the WebDriver viewport size for the active local iOS session, used for coordinate-based taps and swipes.

Local Ios Install App

Install an app on the active local iOS session via ``mobile: installApp``. The path is resolved on the developer machine running Appium, not the backe...

Local Ios Launch App

Activate (launch / foreground) an installed app on the active local iOS session via ``mobile: activateApp``.

Local Ios Navigate Url

Open a URL on the active local iOS session. Android uses an Android VIEW intent through the active Appium session; iOS uses the Safari WebDriver sessi...

Local Ios Screenshot

Capture a PNG screenshot from the active local iOS Appium session. Returns the image so the agent can see what is on screen.

Local Ios Session Info

Inspect the active local iOS Appium session — WebDriver id, base URL, capabilities, and start time.

Local Ios Stop Session

Stop the active local iOS Appium session and release the WebDriver lease so the emulator/simulator is free for the next run.

Local Ios Swipe

Swipe on the active local iOS session via W3C Actions. Use ``up`` to scroll content up, ``down`` to scroll down, etc.

Local Ios Switch Context

Switch the active Appium context on the local iOS session. After switching to a WEBVIEW context, ``*_get_page_source`` returns HTML, ``*_find_element`...

Local Ios Tap

Tap at ``(x, y)`` on the active local iOS session using W3C Actions. Coordinates are WebDriver viewport units.

Local Ios Tap Element

Tap a UI element by its WebDriver element id (from ``local_ios_find_element``).

Local Ios Terminate App

Force-stop an app on the active local iOS session via ``mobile: terminateApp``. Useful between test runs to start from a cold-launch state.

Local Ios Type Text

Type text on the active local iOS session, either into a specific element or the currently focused field.

Local Ios Uninstall App

Uninstall an app from the active local iOS session via ``mobile: removeApp``.

Local Ios Wait For Element

Poll for a UI element on the active local iOS session until it is found or the timeout elapses. Returns the WebDriver element id and its text once pre...

Frequently Asked Questions

What is the Local iOS MCP server?

Drive a local iOS Simulator (or USB-attached device) through the MCPBundles desktop proxy. Tap, swipe, type, take screenshots, inspect UI hierarchies, open Safari URLs, and launch apps using a developer-machine Appium 2.x server. It provides 20 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Local iOS to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/local-ios. Authentication is handled automatically.

How many tools does Local iOS provide?

Local iOS provides 20 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Local iOS require?

Local iOS uses API Key. Local iOS requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Local iOS to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/local-ios

One-click install:

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to Local iOS and paste the MCP URL into Remote MCP server URL.
  4. Click Add. Local iOS will appear under Not connected — select it and click Connect to complete OAuth.
Name: Local iOS
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/local-ios
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Ready to use Local iOS?

Sign in to connect your credentials and start running tools from the chat.