iMessageSAFE

A Deno monorepo containing packages for iMessage access on macOS:

• @wyattjoh/imessage - Core library for read-only iMessage database access
• @wyattjoh/imessage-mcp - Model Context Protocol (MCP) server for LLM integration

Features

• Search messages by text content, contact, or date range
• Get recent messages
• List all chats/conversations
• Get all contacts/handles
• Retrieve messages from specific chats
• Search macOS Contacts by name with iMessage handle ID correlation

Requirements

• macOS (iMessage is only available on macOS)
• Deno 2.x or later
• Read access to ~/Library/Messages/chat.db, or to a custom database configured with IMESSAGE_DB_PATH
• Read access to ~/Library/Application Support/AddressBook/ (for contacts search)

Packages

@wyattjoh/imessage

Core library for accessing iMessage data:

deno add @wyattjoh/imessage

import { openMessagesDatabase, searchMessages } from "@wyattjoh/imessage";

const db = await openMessagesDatabase();
const results = await searchMessages(db, { query: "hello" });
db.close();

See full documentation

@wyattjoh/imessage-mcp

MCP server for LLM integration:

# Run directly from JSR
deno run --allow-read --allow-env --allow-sys --allow-ffi jsr:@wyattjoh/imessage-mcp

# Or install globally
deno install --global --allow-read --allow-env --allow-sys --allow-ffi -n imessage-mcp jsr:@wyattjoh/imessage-mcp

For Claude Desktop app integration, add this to your claude_desktop_config.json:

{
"mcpServers": {
"imessage": {
"command": "deno",
"args": [
"run",
"--allow-read",
"--allow-env",
"--allow-sys",
"--allow-ffi",
"jsr:@wyattjoh/imessage-mcp"
]
}
}
}

Custom Messages Database

Set IMESSAGE_DB_PATH to open a read-only SQLite database at another location, such as a pe