# iMessage Query

> Use this tool when you need to analyze iMessage conversations on macOS, retrieve message history, and gain insights from conversation data. It solves problems like summarizing past discussions, analyzing communication patterns, and extracting action items from chats, while maintaining privacy and security. The tool takes contact information as input and outputs chat transcripts, including text, timestamps, and attachment info, making it ideal for personal productivity use cases.

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

## Description

This MCP server, developed by Hannes Rudolph, enables AI assistants to query and analyze iMessage conversations on macOS. Built with FastMCP and the imessagedb library, it provides read-only access to the iMessage database with robust safety features like phone number validation and attachment handling. The server exposes a 'get_chat_transcript' tool that retrieves message history for specific contacts, including text, timestamps, and attachment info. By connecting AI capabilities with personal messaging data, this implementation allows AI systems to gain insights from conversation history while maintaining privacy and security. It is particularly useful for personal productivity use cases like summarizing past discussions, analyzing communication patterns, or extracting action items from chats.

## Trust

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

## Facts

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

## Source

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

## 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": "hannesrudolph-imessage-query"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/hannesrudolph-imessage-query` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/hannesrudolph-imessage-query/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