Skip to content
The Daily Repo

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

Repos similar to this one
RepoStarsLast commitLicenceDownloads for
JosssphZhou / poki631todayAGPL-3.0Mac
Derrors / iphone-control36todayMITMac, Linux
More: download files, languages, topics and project record

Download files, v1.1.0

  • Mac1 file, 11 downloads

All files on GitHub (opens in new tab)

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

Type to search.

Try