kats1123 / homescreen-mcp
Arrange your iPhone Home Screen from your Mac: drag-and-drop app, CLI and MCP server. Keeps App Library apps in the App Library.
Why this job: name: mcp; says: mcp server; topics: mcp-server, mcp
What it does
- Mac app. one download, nothing to install. It finds connected iPhones and iPads, and keeps a separate draft and backups for each.
- Drag-and-drop editor on the device's real grid (4×6 on iPhone; iPads report their own, e.g. 5×6): real icons, widgets at their real sizes, folders (several pages each), the dock, and page add/move/delete.
- Gaps (empty spaces). Drop an app on any empty spot to place it exactly there. Homescreen writes the gap to the phone and remembers it, so it survives later edits.
- Widgets keep their settings (which script, which person, which city) through every apply.
- App Library that stays put. Apps you keep only in the App Library stay there when you apply, and you can drag apps into or out of it. Most tools get this wrong (why).
Get started
pipx install git+https://github.com/kats1123/homescreen-mcp
homescreen ui You need: A Mac with Apple silicon and macOS 14 or later (the app). The Python package also runs on Intel Macs with Python 3.11+.; An iPhone or iPad connected by USB and trusted ("Trust This Computer").; Tested with iOS 27.0.1 (iPhone 17 Pro Max), iOS 26.6.2 (iPhone 17 Pro), iPadOS 26.6.2 (iPad Air 13") and the iOS 27.2 simulator. Other versions may work; the safety checks will tell you if a write didn't land as planned.
- Maintenance
- Active
- Last commit 8 days ago
- Stars
- 13
- +9 this week
- Licence
- MIT
- Allows business use
- Downloads for
- Mac
- From the latest release
- Latest version
- v1.1.0
- Released 8 days ago
- Built with
- Python
- 67% of the code
Is it looked after?
- Contributors
- 1
- Last 90 days
- Issues
- None
- No issues filed
- Pull requests
- 0 merged
- 1 waiting
- Releases
- 1
- 1 in the last year
- No contributing guide
- No security policy
- No code of conduct
Similar repos
| Repo | Stars | Last commit | Licence | Downloads for |
|---|---|---|---|---|
| JosssphZhou / poki | 631 | today | AGPL-3.0 | Mac |
| Derrors / iphone-control | 36 | today | MIT | Mac, Linux |
More: download files, languages, topics and project record
Languages
- Python 67%
- JavaScript 14%
- CSS 6%
- Swift 4%
Topics
- app-library
- home-screen
- ios
- iphone
- mcp
- mcp-server
- pymobiledevice3
- screen-time
Project record
- JobMCP servers
- StatusNew to our list
- Commits8
- Forks2
- Watching0
- CreatedOct 31, 2026
- First seen by usNov 7, 2026
- CheckedNov 8, 2026
