Hermes Phone Agent

Hermes Agent with MCP servers for Android/iOS phone flashing, unlocking, and management

What is this?

Hermes Phone Agent extends Hermes Agent with Model Context Protocol (MCP) servers for controlling Android and iOS devices. It provides AI-powered phone management, flashing, unlocking, and automation.

Related MCP server: Mobile Testing AI Agent MCP Server

Features

Android Support

• ADB: Full device control (shell, screenshots, input, file transfer)

• Fastboot: Flash partitions, unlock bootloader, reboot modes

• Heimdall: Samsung-specific flashing and PIT extraction

• App Management: Install, uninstall, list packages

• Screen Control: Screenshots, tap, swipe, text input, key events

• System Info: Battery, storage, logs, device properties

iOS Support

• libimobiledevice: Device info, app management, screenshots

• SSH/SFTP: Full access to jailbroken devices

• AFC: Apple File Conduit for file system access

• Backup/Restore: Full device backups

• Jailbreak Tools: checkra1n, palera1n instructions and status

Integration

• MCP Protocol: Works with Claude, Codex, Cursor, and any MCP client

• Hermes Agent: Telegram, Discord, Slack, WhatsApp, Signal gateway

• Windows Desktop: Native Windows support with one-click installer

Quick Start

Windows (Recommended)

1. Download the latest release from Releases

2. Run install.ps1 in PowerShell

3. Launch from desktop shortcut or Start Menu

Manual Install

# Clone the repository
git clone https://github.com/petrobumaga/hermes-phone-agent.git
cd hermes-phone-agent

# Install dependencies
npm install

# Start the agent
npm start

MCP-Only Mode

If you just want the MCP servers without Hermes Agent:

# Android MCP server only
npm run android-mcp

# iOS MCP server only
npm run ios-mcp

Configuration

Configuration file: ~/.hermes-phone-agent/config.yaml

android:
  enabled: true
  adbPath: auto        # Auto-detect or path to adb
  fastbootPath: auto
  heimdallPath: auto

ios:
  enabled: true
  sshUser: root
  sshPassword: alpine  # CHANGE THIS!
  sshPort: 22

hermes:
  enabled: true
  configPath: ~/.hermes/config.yaml

Available Tools

Android Tools (28 tools)

iOS Tools (18 tools)

Use Cases

• Phone Repair: Diagnose and fix bootloops, soft bricks

• Flashing: Install custom ROMs, stock firmware

• Unlocking: Bootloader unlock, FRP bypass

• Jailbreaking: iPhone jailbreak with checkra1n/palera1n

• Automation: Automated testing, UI automation

• Data Recovery: Backup and restore, file extraction

• Security Research: Device analysis, forensic examination

Prerequisites

Android

• Android SDK Platform Tools (ADB, Fastboot)

• USB Debugging enabled on device

• (Optional) Heimdall for Samsung devices

iOS

• libimobiledevice utilities

• (For jailbroken) OpenSSH installed on device

• USB or WiFi connection

Development

# Install dev dependencies
npm install

# Run Android MCP server
npm run android-mcp

# Run iOS MCP server
npm run ios-mcp

# Start all services
npm start

Contributing

1. Fork the repository

2. Create your feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Hermes Agent by Nous Research

• MCP Protocol by Anthropic

• libimobiledevice for iOS support

• Android SDK for Android support

• Heimdall for Samsung flashing

Disclaimer

This tool is for educational and authorized testing purposes only. Always ensure you have proper authorization before modifying device software. The authors are not responsible for any damage caused by misuse of this software.