# vintage

> notes · messages · mail · calls · calendar · contacts — one local graph, for you and your agent.

vintage is a local daemon that indexes your Apple apps — Notes, Messages, Mail, Calls, Calendar, Contacts — into one person-graph on your Mac, and serves it to your terminal and your agent over cli and mcp. local only; nothing leaves the machine.

local. no account. never phones home. A local daemon + cli + mcp server for macOS 15.0+
(Apple Silicon). Pages have a plain-markdown twin at their URL with a .md
suffix; agents sending Accept: text/markdown get markdown at the HTML URLs.

## Install

- terminal: `brew install systemoperators/tap/vintage` then `vintage index sync`
- claude code: `claude mcp add vintage -- vintage mcp --stdio`
- claude desktop: https://vintage.dev/vintage.mcpb
- machine-readable matrix: [install.json](https://vintage.dev/install.json)

## Pages

- [Home](https://vintage.dev/index.md): what vintage is, install, pricing
- [Unlock](https://vintage.dev/unlock.md): the one-time engine purchase + agent-assisted flow
- [iMessage MCP server — search Messages from Claude, locally](https://vintage.dev/imessage-mcp-server.md): answers "imessage mcp server"
- [Connect Apple Notes to Claude — local MCP, full note bodies](https://vintage.dev/apple-notes-claude.md): answers "apple notes claude"
- [Export iMessage to Claude — without exporting anything](https://vintage.dev/export-imessage-to-claude.md): answers "export imessage to claude"
- [Search Apple Mail with AI — local index, agent tools](https://vintage.dev/search-apple-mail-with-ai.md): answers "search apple mail with ai"
- [Apple Contacts MCP — your people, as the index key](https://vintage.dev/apple-contacts-mcp.md): answers "apple contacts mcp"
- [Call history on macOS — a queryable local API](https://vintage.dev/call-history-mac-api.md): answers "call history mac api"
- [Apple Calendar MCP — events in the same graph as everything else](https://vintage.dev/apple-calendar-mcp.md): answers "apple calendar mcp"
- [Apple Reminders MCP — read free, write with the engine](https://vintage.dev/apple-reminders-mcp.md): answers "apple reminders mcp"
- [Search iMessage from the terminal — fzf-fast, person-aware](https://vintage.dev/search-imessage-from-terminal.md): answers "search imessage from terminal"
- [Apple Mail MCP server — full bodies, people, receipts](https://vintage.dev/apple-mail-mcp-server.md): answers "apple mail mcp server"

## Capabilities

- answer from everything you’ve written or received — "what did livia and i plan for miami?" pulls notes, messages, mail and calendar together
- who you owe replies · today’s briefing · person timelines
- search every source with one tool — keyword-ranked free
- understand: ocr on attachments, entities, meaning search (engine tier, one-time unlock)
- act: create notes, reminders, events — full private api, not the applescript subset (engine tier, one-time unlock)

## Interfaces

- cli: `vintage <resource> <action> --json` (notes, messages, mail, files, people, companies, calendar, search)
- mcp: localhost:8787/mcp (streamable http) or `vintage mcp --stdio` — tools: search, person, unreplied, replies, recent
- tui: `vintage tui`