# search your mail like you remember it, not like you filed it

vintage indexes every message in Mail.app — bodies extracted from the store, attachments, pdf text — into a local full-text index, with each sender resolved to a person in your graph.

ask claude "the hotel confirmation from the lisbon trip" and it searches mail together with the messages and notes around it. keyword ranking is free; meaning-based search is the paid engine.

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
claude mcp add vintage -- vintage mcp --stdio
vintage search "lisbon hotel"     # terminal works too
```

## what gets indexed

- full message bodies, not just subjects
- pdf attachments — invoices and receipts become searchable text
- senders resolved to people (with their messages, notes, calls alongside)
- apple’s own mail categories (transactions, updates, promotions) as filters

## honest limits

- semantic ("meaning") search and attachment ocr are engine features — keyword search is free
- vintage reads the local Mail.app store; mail not downloaded to the mac is not indexed

## questions

**does searching send my mail to an api?**
no. the index and the search both run on your mac. even the engine’s semantic search runs local models.

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