iOS Development Bridge (idb)

iOS Development Bridge (idb)

noahlozevski

Integrates with Facebook's iOS Development Bridge to automate iOS device management, app installation, and UI interactions through MCP. Requires idb-companion installed via Homebrew.

Integrates with Facebook's iOS Development Bridge (idb) to enable automated iOS device management, test execution, UI interactions, and app installation through a simple npm module.

6518 views5Local (stdio)

What it does

  • Install and remove iOS applications
  • Take screenshots of iOS devices
  • Automate UI interactions and taps
  • Execute automated tests on iOS devices
  • Manage iOS device connections
  • Control iOS devices programmatically

Best for

iOS developers building automated testsQA teams doing screenshot testingMobile app CI/CD pipelinesAutomating iOS device workflows
Requires Facebook's idb-companionDirect iOS device controlZero-config npm installation

About iOS Development Bridge (idb)

iOS Development Bridge (idb) is a community-built MCP server published by noahlozevski that provides AI assistants with tools and capabilities via the Model Context Protocol. Easily manage iOS devices, automate tests, and install apps with iOS Development Bridge (idb). Ideal for barcode scannin It is categorized under developer tools.

How to install

You can install iOS Development Bridge (idb) in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

License

iOS Development Bridge (idb) is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

mcp-idb

MCP server integration for Facebook's iOS Development Bridge (idb).

Overview

This package provides integration between MCP (Model Context Protocol) and Facebook's idb (iOS Development Bridge), enabling automated iOS device management and test execution through MCP.

Start the server:

npx -y @noahlozevski/mcp-idb

Prerequisites

Installing idb

To install idb:

brew tap facebook/fb
brew install idb-companion

# verify installation
idb

For more details, visit the official idb GitHub repository.

Configuration

mcp-config.json Setup

To use idb in your MCP configuration, add the following to your mcp-config.json:

{
  "mcpServers": {
    "idb": {
      "command": "npx",
      "args": ["-y", "@noahlozevski/idb"]
    }
  }
}

Example use cases include:

  • Automated test development
  • Screenshot testing
  • Automated interactions ("tap the home button on the screen")
  • Installing / removing applications

Development

Code Formatting

This project uses Prettier for code formatting. To format your code:

npm run format        # Format all files

The formatting configuration can be found in .prettierrc at the root of the project.

Troubleshooting

Common issues and solutions:

  1. idb companion not found: Ensure idb-companion is installed via Homebrew
  2. Device not detected: Make sure the iOS device is:
    • Connected via USB
    • Trusted on the computer
    • Has developer mode enabled

Contributing

Please follow the standard MCP contribution guidelines when making changes to this package.

License

This project is part of Mobile Control Plane (MCP) and follows Amazon's internal licensing policies.

Alternatives

Related Skills

Browse all skills
ios-developer

Develop native iOS applications with Swift/SwiftUI. Masters iOS 18, SwiftUI, UIKit integration, Core Data, networking, and App Store optimization. Use PROACTIVELY for iOS-specific features, App Store optimization, or native iOS development.

6
environment-setup-guide

Guide developers through setting up development environments with proper tools, dependencies, and configurations

1
granola-local-dev-loop

Integrate Granola meeting notes into your local development workflow. Use when setting up development workflows, accessing notes programmatically, or syncing meeting outcomes with project tools. Trigger with phrases like "granola dev workflow", "granola development", "granola local setup", "granola developer", "granola coding workflow".

1
godot

This skill should be used when working on Godot Engine projects. It provides specialized knowledge of Godot's file formats (.gd, .tscn, .tres), architecture patterns (component-based, signal-driven, resource-based), common pitfalls, validation tools, code templates, and CLI workflows. The `godot` command is available for running the game, validating scripts, importing resources, and exporting builds. Use this skill for tasks involving Godot game development, debugging scene/resource files, implementing game systems, or creating new Godot components.

732
csharp-developer

Expert C# developer specializing in modern .NET development, ASP.NET Core, and cloud-native applications. Masters C# 12 features, Blazor, and cross-platform development with emphasis on performance and clean architecture.

38
interactive-portfolio

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities. Use when: portfolio, personal website, showcase work, developer portfolio, designer portfolio.

22