Detox MCP

An MCP (Model Context Protocol) server for integrating the Detox mobile testing framework with Claude Code.

Features

• Test Execution: Build and run Detox E2E tests with full options

• Configuration Management: Read, validate, and generate Detox configurations

• Code Generation: Generate test code, matchers, actions, and expectations

• Device Management: List iOS simulators and Android emulators

• Resources: Access configuration, devices, tests, and API reference

• Prompts: Slash commands for common workflows

Installation

npm install -g detox-mcp

Or install locally in your project:

npm install detox-mcp

Usage with Claude Code

Add to Claude Code

# Add globally
claude mcp add detox-mcp

# Or with npx
claude mcp add --transport stdio detox-mcp -- npx detox-mcp

Project Configuration

Create .mcp.json in your project root:

{
  "mcpServers": {
    "detox": {
      "command": "npx",
      "args": ["detox-mcp"],
      "env": {
        "DETOX_PROJECT_PATH": "/path/to/your/react-native/project"
      }
    }
  }
}

Available Tools

Test Execution

Configuration

Code Generation

Devices

Resources

Access contextual data via the resource URIs:

Prompts (Slash Commands)

Use these prompts in Claude Code for common workflows:

Examples

Run Tests

Ask Claude: "Run my Detox tests on iOS simulator"

Claude will use detox_build and detox_test tools to execute your tests.

Generate Test Code

Ask Claude: "Generate a Detox test for the login flow"

Claude will use detox_generate_test to create test code.

Check Configuration

Ask Claude: "What Detox configurations are available?"

Claude will use detox_list_configurations to show available configs.

Requirements

• Node.js 18+

• Detox installed in your React Native project

• For iOS: Xcode and applesimutils

• For Android: Android SDK and emulator

Environment Variables

Development

# Clone the repo
git clone https://github.com/your-username/detox-mcp

# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev

License

MIT