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. · everything vintage does · the engine