Skip to content
imessage-relay

imessage-relay

Expose Apple Messages as a local HTTP API on macOS. Read and search chat history, download attachments, and send texts from one native Swift binary.

Reads go directly to ~/Library/Messages/chat.db. Sends use Messages.app’s AppleScript interface. The relay does not use private frameworks or process injection.

Start here

Section titled “Start here”

Install the relay and make your first request. You need macOS 14 or newer and Full Disk Access for the process running the relay.

Integrate with the API

Section titled “Integrate with the API”
  • API reference covers endpoints, parameters, response details, and send errors.
  • Pagination explains cursors, database fingerprints, and restarting traversal.
  • Configuration covers listening addresses, authentication, and recipient permissions.
  • Troubleshooting covers macOS permissions and compatibility.

Source code and releases are available on GitHub.