Ios Files

What is Ios Files?

Ios Files is an MCP server that provides controlled SSH/SFTP access to an iOS device’s filesystem. It allows AI assistants or coding agents to browse, read, and (optionally) write files on a jailbroken or SSH‑enabled iOS device.

How to use Ios Files?

Install Node.js 20+ and ensure OpenSSH is running on the iOS device. Run the installer command with your client (e.g., --client codex), device host, and password. The server writes the MCP configuration automatically for supported clients (Codex, Claude Desktop, OpenCode, VS Code). USB SSH is supported via iproxy and localhost forwarding.

Key features of Ios Files

• Read‑only by default; optional write capability with approval system.
• List, stat, search, and hash files on the iOS device.
• Read text files, plists, SQLite databases, and React Native bundles.
• Detect installed apps and resolve their containers.
• Inspect and decode Hermes bytecode bundles.
• Static analysis via radare2 (device‑side or local fallback).
• Supports all major MCP clients with automatic config setup.

Use cases of Ios Files

• Inspect app data containers and preference plists for debugging.
• Read logs, configuration files, or SQLite databases from an iOS device.
• Explore file system structure during reverse engineering or security analysis.
• Copy or zip files from the device to a local computer for offline analysis.
• Decode React Native Hermes bytecode bundles for inspection.

FAQ from Ios Files

Is the server read‑only by default?

Yes. Writes require setting "readOnly": false and "allowWrites": true. Write‑capable tools first return an approval request; the exact operation must be re‑sent with the approval ID.

What dependencies are required?

Node.js 20+ on the computer, an OpenSSH server running on the iOS device, and network connectivity from computer to device.

Where does the data live?

All file operations are performed over SSH/SFTP to the iOS device. No files are stored permanently on the computer unless you explicitly download them.

Are there any blocked paths?

Yes. The server blocks access to /var/Keychains, /var/mobile/Library/Accounts, /var/mobile/Library/SMS, /System, /usr, /bin, /sbin, and others by default.

What authentication methods are supported?

Password and SSH key authentication are supported. Set via env vars IOS_FILES_MCP_PASSWORD or IOS_FILES_MCP_KEY_PATH.