# an imessage mcp server that never leaves your mac

vintage indexes your Messages history — every chat, linked to the person behind it — into a local SQLite graph, and serves it to Claude (or any MCP client) over stdio or local HTTP.

it is not only imessage: the same index carries notes, mail, calendar, contacts and call history, so "what did livia and i plan?" answers across all of them in one tool call.

vintage runs entirely on your Mac: it reads the local Apple databases, builds one person-graph index, and serves it over cli and mcp. no cloud, no account, nothing leaves the machine.

## try it

```
brew install systemoperators/tap/vintage
vintage index sync   # permission grants + first sync
claude mcp add vintage -- vintage mcp --stdio
```

## mcp tools your agent gets

- search — keyword search across messages and every other source
- person — a timeline of everything with one person
- unreplied — chats where the last word is theirs, waiting on you
- replies — what you owe, ranked
- recent — the latest across sources

## honest limits

- macOS 15+, Apple Silicon; needs Full Disk Access to read the Messages store
- sending messages is not included — the free tier is read-only by design

## questions

**does my imessage history leave my mac?**
no. the index lives in ~/.vintage on your machine and the mcp server binds locally. there is no cloud component and no account.

**does it work with claude desktop?**
yes — a one-click .mcpb bundle (vintage.mcpb) installs the server into claude desktop; claude code uses the one-line claude mcp add command.

---
local. no account. never phones home. · https://vintage.dev/ · unlock: https://vintage.dev/unlock · agents: https://vintage.dev/llms.txt