# your call history, finally queryable

macos keeps your iphone’s call log on the mac (continuity), but apple ships no api for it. vintage reads the local call-history store and makes it part of your person-graph: every call joined to the person, next to their messages and mail.

query it from the terminal with --json, or let your agent use it over mcp — "when did i last actually talk to dana?" distinguishes a call from a text.

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
vintage search "dana" --kind call --json
claude mcp add vintage -- vintage mcp --stdio
```

## what you get

- calls with direction, duration and timestamp
- numbers resolved to contacts — persons, not digits
- calls in person timelines alongside messages and mail
- json output for scripts; mcp tools for agents

## honest limits

- reads the mac’s synced call store — calls that never synced from the iphone aren’t there
- read-only; vintage does not place calls

## questions

**is there really no official api?**
not a public one on macos. tools either scrape backups or read the local store; vintage does the latter, on your machine, with full disk access you grant once.

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