Organize your iPhone home screen from any AI client via MCP — no jailbreak, widgets preserved
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"ios-icon-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# ios-icon-mcp [](https://github.com/huangzheng2016/ios-icon-mcp/actions/workflows/ci.yml) [](https://pypi.org/project/ios-icon-mcp/) [](https://pypi.org/project/ios-icon-mcp/) Organize an iPhone home screen from any MCP-compatible AI client. Move apps and web clips, create folders, rearrange pages, and inspect widget-aware text layouts with natural language. **No jailbreak, device supervision, or Apple Configurator is required.** [中文版 README](README.zh-CN.md) > **Warning:** This project uses private iOS APIs through pymobiledevice3. Compatibility can change with iOS updates. Use the preview and backup features before writing. ## Features - Read apps, folders, web clips, and widgets, including localized names and bundle IDs. - Render pages as text grids using the device's reported rows and columns. - Edit a saved layout or make a direct change on the device. - Create folders, including folders with multiple pages. - Preview changes by default before applying a layout file. - Refuse unknown IDs, accidental app removal, over-capacity pages, and widget displacement. - Back up automatically before every write and verify the resulting layout and widgets. - Restore complete backups, with a preview and a fresh safety backup. ## Requirements - macOS with its built-in `usbmuxd`. - One iPhone connected over USB, unlocked, and trusted by the Mac. - [uv](https://docs.astral.sh/uv/), which provides the `uvx` command. The MCP server needs Python 3.10 or newer; `uvx` handles the Python environment and dependencies. ## Install Add this to your MCP client's configuration: ```json { "mcpServers": { "ios-icon": { "command": "uvx", "args": ["ios-icon-mcp"] } } } ``` Restart the MCP client after changing its configuration. The first run downlo…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.