How to organize your iPhone home screen with AI

Short answer

iOS has no setting that lets an AI assistant rearrange your home screen, but an AI agent on your Mac can plan the layout for you in TidyGrid, which gives it your pages, apps and icon colours. Copy the one-sentence prompt from TidyGrid into an agent such as Claude Code, Codex and Cursor, say what layout you want, check the draft it proposes on your Mac, and press Apply yourself when it looks right.

Each request goes through TidyGrid's MCP server, the same way an agent sends it, and only changes the draft. 27 seconds, music only, no narration.

In a Reddit thread on r/mcp about letting an AI agent arrange a home screen by colour (181 comments in our snapshot), people asked which MCP server was used, how it was connected, and what the prompt was. A separate r/iphone post asking whether people would describe a layout and have it done in seconds drew 25 comments. Outside those threads we found almost no one asking this yet.

How it works

TidyGrid reads your iPhone or iPad home screen over a cable and keeps it on your Mac as a draft. An agent running on the same Mac can look at that draft and replace it with a new one, either by running TidyGrid's own commands (what the copied sentence asks it to do) or through TidyGrid's MCP server. Both give it the same five tools:

  • get_layout: the Dock, pages, folders and widgets as TidyGrid read them.
  • get_icons: the main colours of each icon, so it can group or order by colour.
  • evaluate_layout: checks a planned layout fits the grid and that no app went missing, without changing anything.
  • propose_layout: replaces the draft in the TidyGrid window. You can undo it like any other change.
  • list_backups: the layouts TidyGrid saved before earlier applies.

Setting it up

  1. Connect the iPhone to your Mac with a cable, tap Trust if asked, and open TidyGrid so it reads the home screen.
  2. Open AI agents in TidyGrid's sidebar, pick an example or type what you want, and press Copy.
  3. Paste the sentence into Claude Code, Codex or Cursor. It tells the agent to run TidyGrid's guide command and follow it. Codex asks you once to let the command run outside its sandbox.
  4. Watch the draft change in the TidyGrid window. Undo, ask for changes, or adjust by hand.
  5. When you are happy, press Apply in TidyGrid. The agent cannot do this step.

Using the Claude desktop app instead

For the Claude desktop app, which cannot run commands, or if you want it set up for good, add TidyGrid as an MCP server instead. The same panel shows the lines to copy.

What to ask for

Agents work well with clear rules. Some prompts that work well:

  • “Keep my Dock and first page as they are. Put everything else in folders by what the apps are for, with short folder names.”
  • “Move every game into one folder on the last page, and put the apps I left in the App Library into a folder called Rarely.”
  • “Put my pages in rainbow order by icon colour, but keep the widgets where they are.”
  • “List apps that look like they do the same job. Do not move anything yet.”

Do you need an AI for this?

Not for simple orders. TidyGrid's Arrange puts every app on your pages in order by color or A to Z in one click, without an agent. Where an agent helps is judgement: grouping by purpose, naming folders, or following your own rules like “work apps on page two”.

Many people prefer their apps not to move at all because they find them by memory. An agent proposal is a draft, so you can look at it and throw it away with one undo.

Who this works for

  • Agents that can run commands on your Mac, including Claude Code, Codex and Cursor, with no setup. Agents that support MCP, such as the Claude desktop app, through TidyGrid's MCP server.
  • TidyGrid needs a Mac with Apple silicon and a cable between the device and the Mac. Reading a layout is tested on iPadOS 15, iOS 16, iOS 17, iOS 26 and iOS 27.
  • TidyGrid can apply a layout or restore a backup on iOS and iPadOS 15 and later. Writing has been tested on real devices running iPadOS 15.3.1 and iOS 27.2; other versions have not yet been tested one by one on a real device. After every write, TidyGrid reads the layout back and checks each position: if it does not match, TidyGrid tries once more in Apple's other format, and if it still does not match, it tells you and you can restore the backup from before the write in one click.

What it cannot do

  • The agent cannot write to your iPhone or iPad. There is no command or tool for that; only you can press Apply.
  • The agent can only move icons that are already there. It cannot install or delete apps, add widgets or change icons.
  • Neither TidyGrid nor the agent can know how often you use each app, unless you tell the agent.
  • TidyGrid cannot see empty spaces you left between icons on purpose, so neither Arrange nor an agent can keep them.

Questions

Does the agent see my data?

It sees what TidyGrid's tools return: app names, the layout and icon colours. Your layout, app list and icons are stored only on your Mac, but whatever the agent reads is handled by the agent and the AI service it uses, under their terms.

Can I use a chat assistant in a browser?

TidyGrid runs on your Mac, so the agent needs to run on that Mac too and be able to run commands or use MCP. Agents such as Claude Code, Codex and Cursor do.

What if I move an app by hand while the agent is working?

You and the agent edit the same draft with the same undo history. If the agent proposes a layout after your change, its proposal replaces the draft, and you can undo back to your version.

Is the AI agent support part of the paid license?

The agent commands and the MCP server come with the app. Arranging and previewing, by hand or with an agent, are free. Applying to the device needs the $9.99 one-time license.

Arrange it on your Mac

TidyGrid shows every home screen page side by side and writes the result back. Free to download, arrange and preview; $9.99 once to apply.