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 permission request. The exact command or file, the project, and two buttons, Allow and Deny; press and hold for Allow for this session and Always allow this command. Claude carries on as soon as you tap.
- A question. When Claude asks you to choose, the options come with it. Pick one and the answer goes back to Claude Code.
- A finished turn. What Claude just did, in a line. Reply from the notification and your message becomes its next instruction.
- A session card. One card per session on the lock screen and in the Dynamic Island, updated in place instead of a pile of notifications: the step Claude is on while it works, and the request itself, with Allow and Deny, when it needs you.
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
- An iPhone with iOS 17.2 or later. There is no account to create: the app makes a random key on the phone.
- Claude Code installed on the computer, and started at least once, so that
~/.claudeexists. curl, which macOS and most Linux systems have. The install command fetches themonishcommand for your computer; it needs no Node.- macOS or Linux, in any terminal: Terminal, iTerm2, Ghostty, the terminal of your IDE, or a server over SSH. Windows, in PowerShell or Windows Terminal, is in beta.
No Claude plan is needed: hooks run on your computer, whatever Claude Code is signed in with.
Pair in one command
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.
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 482913The 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 | iexthenmonish pair 482913. If you paired withnpx, putnpxin front of themonishcommands below.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:
- In the app’s Settings, Send a test question and Send a test live card show each kind of card without your computer.
- On the computer,
monish statuschecks the setup. - Still on the computer,
monish testsends the same test request from there and waits for your tap. It prints the answer, such asAllowed from your iPhone in 4 s. Nothing was run. - Then start
claudein 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 withclaude --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.
| Hook | When Claude Code runs it | What Monish does |
|---|---|---|
PermissionRequest | Just before it shows a permission prompt or a multiple-choice question | Sends the request to your iPhone and hands your answer back |
Stop | When Claude finishes responding | Sends Done with Claude’s last message; your reply becomes the next instruction |
Elicitation | When an MCP server asks for input | Sends short forms to your iPhone |
StopFailure | When a turn ends on an API error | Sends an alert with the error |
PostToolUse | After a tool has run | Updates the step on the session card, and closes on your iPhone a request already answered in the terminal |
UserPromptSubmit | When you send a prompt | Starts 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
- Approve Claude Code permissions from your iPhoneHow a hook hands your Allow or Deny back to Claude Code.
- Answer Claude Code’s questions from your iPhoneAskUserQuestion, how a hook answers it, and forms from MCP servers.
- Claude Code on your lock screen and Dynamic IslandOne card per session, with Allow and Deny on it, and what iOS allows.
- Long Claude Code tasks: how to step awayWhy long tasks stall, and how to keep one moving while you are out.
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.