Language: 日本語English

imessage Plugin

Category
Productivity
Topics
Project Management & Collaboration · Claude Code Customization & Workflow
First seen
2026-07-09
Last confirmed
2026-07-13
Explanation last updated
2026-07-12

The explanation below is AI-generated. Please verify it against the sources.

imessage is a Claude Code plugin (macOS only) that connects iMessage to a Claude Code assistant by reading ~/Library/Messages/chat.db directly for history, search, and new-message detection, and sending replies via AppleScript to Messages.app. According to the README, there is no external server or background process to keep alive. Access is controlled by an allowlist policy managed through /imessage:access; by default only self-chat (texting yourself) bypasses the gate, and other senders are dropped silently until allowlisted. Setup requires granting Full Disk Access for chat.db, installing the plugin, and relaunching Claude Code with the --channels plugin:imessage@claude-plugins-official flag. The README notes limitations: AppleScript can send messages but cannot do tapback, edit, or threading, which require Apple's private API.

Overview

According to the README, imessage is a Claude Code plugin that bridges iMessage messaging with a Claude Code assistant, using direct chat.db reads for inbound messages/history and AppleScript for outbound sending, with built-in access control via allowlists.

What you can do with imessage

  • Read iMessage history and search past conversations directly from chat.db (per README)
  • Detect new inbound messages via polling chat.db once per second
  • Send replies and file attachments to a chat using the reply tool (AppleScript-based)
  • Fetch recent conversation threads (DM or Group) with the chat_messages tool, per chat or across all allowlisted chats
  • Manage pairing, allowlists, and policy via /imessage:access (e.g., /imessage:access allow +15551234567)
  • Configure behavior via environment variables: IMESSAGE_APPEND_SIGNATURE, IMESSAGE_ALLOW_SMS, IMESSAGE_ACCESS_MODE, IMESSAGE_STATE_DIR
  • Text yourself to reach the assistant immediately, since self-chat always bypasses access control

Sources

Original description (English)

iMessage messaging bridge with built-in access control. Reads chat.db directly, sends via AppleScript. Manage pairing, allowlists, and policy via /imessage:access.

History of imessage

Back to list