iMessage for Claude Code

by AnthropicPluginGet updates sent to me

Lets you text your running Claude Code session from iMessage and get replies there

About iMessage for Claude Code

A plugin that connects the Messages app on your Mac to a running Claude Code session. You text yourself from your phone or another device, and Claude works at your computer and replies in the same thread.

For Claude Code users on a MaciPhone usersPeople who leave long tasks running

Made by Anthropic

Anthropic is an AI research company, set up as a public benefit corporation, that makes the Claude models and apps.

Stars: ★ 45k
License: Apache-2.0
Cost: Free
For: Claude Code
Contents: Includes scripts

Overview

iMessage for Claude Code is Anthropic's channel plugin that connects the Messages app on your Mac to an open Claude Code session. You text yourself from your iPhone or another device; Claude works on it at your computer and replies in the same thread. It reads the Mac's Messages database directly and sends through the Messages app, so there is no bot or outside server to set up. It suits Mac users who leave Claude Code running and want to check in from their phone.

It needs no bot token or outside service: you text yourself, and other people's messages stay out until you add them by phone number or email.

Try these first

Start with the first one: it is a small task you can check easily.

Text yourself: "What are you working on right now? Answer in one line."First try · self-chat only
"Has the build finished? If it failed, tell me the first error."
Send a photo of a handwritten list and ask: "Add these items to the project's task notes."writes files
"Look through our recent messages in this chat and remind me what I asked you to do this morning."

Example prompts written by Agent Flows Hub.

What you get

From the creator's documentation.

Output	What it is	Reads
Replies in iMessage	Claude's answers sent through the Messages app on your Mac, with files as separate messages	Connected tools
Texts and photos in	Your texts and the images in them reach the open Claude Code session	Connected tools
Message history	Reads past messages in allowed chats straight from your Mac's Messages database	Your Messages history
Allowlist	Only your own texts get through until you add other people's numbers or emails	Your computer
Permission prompts	Approve or deny Claude's tool requests by replying in your self-chat	Connected tools
Work at your desk	Claude acts in the running session on your Mac, including your project files	Your files

Good to know

Text an already running Claude Code session from your phone through iMessage. The plugin passes your messages into the session and sends Claude's reply back to the same conversation on your Mac's Messages app.

Limits

It works only on a Mac, needs Bun, and needs Full Disk Access for your terminal so it can read the Messages database, which holds your whole message history. The session must be started with the channels flag and keep running.
Only your own texts get through at first. Add other people by phone number or Apple ID email only if you trust them, because allowed senders reach a session that can act on your files.

Notes by Agent Flows Hub (original project name: imessage (Claude Code channel plugin)), written from the creator's documentation, not from running it ourselves. imessage (Claude Code channel plugin): README and setup · Claude Code channels documentation

Stuck setting it up?

Tell us what happened. We take a look first; if it needs paid work, you get an estimate before anything starts.

Get help

How to start

Install Claude Code firstThe plugin adds to Claude Code; it does not work on its own.
Type the commands into Claude CodePaste the install request into Claude Code, or enter these lines yourself one by one or follow the official guide./plugin install imessage@claude-plugins-official
Give it a first taskText yourself a harmless status question from your phone and check that the reply arrives in the same thread. Add no other contacts until you have checked the setup.

Steps follow the creator's instructions. The request tells your agent to read them first and wait for your OK.

Before you start

Claude Code, installed.
A Mac with the Messages app signed in to your Apple ID
Bun, the JavaScript runtime the plugin's server runs on
Full Disk Access for your terminal app, which macOS asks for on first use
Claude Code signed in through claude.ai or a Console API key
It runs scripts and connects to the internet. Read the official page to see what it does before installing.
Free. Nothing to pay.

Details

Made by: Anthropic
License: Apache-2.0 Terms
For: Claude Code
Runs on: Your computer

View source Official docs Report a problem

For AI agents

This page as a Markdown install brief:

/en/library/claude-code-imessage/install.md

Other plugins

Lemo-Opuscar Turns your topic into a short animated film in one of 66 ready-made visual styles
NotFair Marketing Plugin Adds 48 SEO, analytics and ad-account skills to Claude Code and other agents
NPMScan Checks whether an npm package has known security problems before you install it
Obsidian Second Brain Lets Claude Code save, find and update notes in your Obsidian vault across sessions
OpenCode Notifier Plays a sound and shows a desktop alert when OpenCode finishes, fails or needs your OK
Receipts for Claude Code Makes a printable report of what your Claude Code use shipped, by project, for a manager

See all 30 plugins

GitHub