# iMessage

> Use this tool when you need to access and analyze macOS iMessage data, such as searching messages, retrieving conversations, and accessing contact information. It solves problems related to conversational access to message history, contact correlation, and message analytics, providing a read-only interface to the iMessage database. The tool takes query inputs and returns relevant data outputs, making it suitable for use cases where AI assistants require insight into iMessage data without requiring complex database knowledge.

Canonical page: https://skillsregistry.net/skills/wyattjoh-imessage  
JSON: https://api.skillsregistry.net/v1/skills/wyattjoh-imessage

## Description

MCP server implementation by Wyatt Johnson that provides AI assistants with read-only access to macOS iMessage data through six specialized tools for searching messages, retrieving conversations, and accessing contact information. Built as a Deno monorepo with two packages - a core library for direct iMessage database access and an MCP server wrapper - the implementation directly queries the macOS Messages SQLite database and AddressBook databases using functional programming patterns with comprehensive pagination support. The server handles Apple's unique timestamp format conversion, decodes NSAttributedString message content, normalizes phone numbers for iMessage handle matching, and includes lazy database initialization with proper error handling, making it valuable for users wanting conversational access to their message history, contact correlation, and message analytics without requiring complex database knowledge or manual file access.

## Trust

- **Trust score (0–1):** 0.64
- **Verification tier:** scanned
- **Last scanned:** 2026-09-01

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** database
- **Updated:** 2026-09-01

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/wyattjoh-imessage)
- **Repository:** <https://github.com/wyattjoh/imessage-mcp>

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "wyattjoh-imessage"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/wyattjoh-imessage` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/wyattjoh-imessage/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt