Claude Code notifications on your iPhone: setup

Updated

Quick answer

To get Claude Code notifications on your iPhone, install Monish, then run the install command it shows on your computer: curl -fsSL https://monish.cc/install.sh | sh -s with your 6-digit code. The command adds Claude Code hooks to ~/.claude/settings.json. From then on your iPhone gets a push when Claude finishes, asks a question or wants a permission, and you can allow, deny or reply from the lock screen. Monish is free and needs no account.

What you get

Once your computer is paired, Claude Code’s hooks send four moments to your iPhone:

A request sent to your iPhone also stays on screen in your terminal: answer wherever you are, and the first answer wins. If you would rather not install anything, Claude Code has its own push through Remote Control and the Claude app, which needs a Claude plan. The four ways to follow Claude Code from an iPhone puts them side by side.

Before you start

No Claude plan is needed: hooks run on your computer, whatever Claude Code is signed in with.

Pair in one command

  1. Install Monish

    Get it free on the App Store and allow notifications when it asks. Without them, requests still reach the app, but nothing shows on your lock screen. The app then shows the command to run, with your 6-digit code in it.

  2. Run the command on your computer

    Open a terminal on the computer where you use Claude Code, and run the command with your code:

    curl -fsSL https://monish.cc/install.sh | sh -s 482913

    The code is good for 10 minutes; after that, tap Get a new code in the app. On a Mac signed in to the same Apple Account, tap Copy in the app and paste it straight away, or tap Send to my computer to share a link to the command.

    Other ways to install, in the app, gives two more lines: npx monish pair 482913, with Node 18 or later, and for Windows, in PowerShell, irm https://monish.cc/install.ps1 | iex then monish pair 482913. If you paired with npx, put npx in front of the monish commands below.

  3. Answer the test

    The app switches to Connected to and the name of your computer, and shows a test request, Run this command? echo "Hello from Monish", with Allow and Deny. Answer it to finish. Nothing is run.

Check that it works

Four checks, from the quickest to the real thing:

  1. In the app’s Settings, Send a test question and Send a test live card show each kind of card without your computer.
  2. On the computer, monish status checks the setup.
  3. Still on the computer, monish test sends the same test request from there and waits for your tap. It prints the answer, such as Allowed from your iPhone in 4 s. Nothing was run.
  4. Then start claude in a project, give it a task, and step away. To see a permission request, switch to Manual mode first: press Shift+Tab until the status bar shows ⏸ manual mode on, or start with claude --permission-mode manual. Since version 2.1.283, Claude Code starts in auto mode, where a classifier approves most actions and few prompts appear.

Two things can make a first test look silent. While you’re typing in the terminal, Claude asks there as usual and the request reaches your iPhone as a silent note, without a sound. And in a folder you have never opened with Claude Code, hooks wait until you accept the folder’s trust dialog.

What the command changed on your computer

The install command does three things: it installs the monish command, pairs this computer with your iPhone, and adds Monish’s hooks to ~/.claude/settings.json, after saving a backup of the file. A hook is a command that Claude Code runs at a fixed moment of a session. The command adds six:

Swipe the table sideways to see all columns.

HookWhen Claude Code runs itWhat Monish does
PermissionRequestJust before it shows a permission prompt or a multiple-choice questionSends the request to your iPhone and hands your answer back
StopWhen Claude finishes respondingSends Done with Claude’s last message; your reply becomes the next instruction
ElicitationWhen an MCP server asks for inputSends short forms to your iPhone
StopFailureWhen a turn ends on an API errorSends an alert with the error
PostToolUseAfter a tool has runUpdates the step on the session card, and closes on your iPhone a request already answered in the terminal
UserPromptSubmitWhen you send a promptStarts the session card, Working, and closes on your iPhone the requests you answered at the keyboard

To see them, type /hooks in Claude Code: each hook is listed with the file it comes from. Claude Code hooks explained covers the format.

What leaves your computer is only what a notification and the session card need: the project name, the step Claude is on, Claude’s message or question, and the command or file a permission request is about. For a file edit, up to 12 of the changed lines. Never a whole file. Our server keeps a notification 48 hours, so the app can catch up on one you missed, then deletes it. Answers are kept 24 hours.

One thing depends on how you run Claude Code. In auto or bypassPermissions mode, Claude asks for few or no permissions, so there is little to allow or deny; its questions and finished turns still reach your iPhone.

Add or remove a computer

Each computer is paired on its own: in the app, Setup › Computers › Add a computer gives a new install command with a new code. For a server you reach over SSH, run the command on the server, where Claude Code runs. Each computer has its own page under Setup › Computers: its name, and the commands you chose to always allow there, each with its project, which you can remove. The answer window, quiet hours and Live Activities are set once, in the app’s Settings, for every computer.

To remove one, run monish uninstall on it: the command removes the hooks and unpairs the computer. Remove this computer, on its page in the app, stops it from reaching your iPhone, but leaves the hooks in place until you run the uninstall command there. Delete account in the app erases everything, on the iPhone and on our server.

Questions

Do I need a Claude Pro or Max plan?
No. Hooks run on your computer, so Monish works the same whether Claude Code is signed in with a Claude plan, an API key or a cloud provider.
The command says my code is not valid. What now?
Codes last 10 minutes. Open Monish, tap Get a new code if the old one has expired, and run the command again with the code on screen.
Does it work on Windows and Linux?
Yes. Monish runs through Claude Code’s hooks, so it works on macOS and Linux, in any terminal, an IDE terminal or a server over SSH. Windows support is in beta, with its own install line under Other ways to install in the app.
What if I don’t answer a request?
Nothing is decided for you. Your iPhone can answer within the answer window, set in the app’s Settings: 10 minutes by default, or 2, 5 or 30 minutes, or 1 hour. After that, Claude Code asks you in the terminal.

More guides

New to Monish? The home page shows what lands on your iPhone, and all guides are listed here.

Get Monish on your iPhone

Free, no account. Your 6-digit code is waiting in the app.

Download on the App Store