What gets auto-logged
- Sender / receiver handles (phone, email)
- Timestamp of each message
- Conversation thread identifier
- Message direction (incoming / outgoing)
- Optional: message body if you opt in explicitly
Setup (5 minutes)
- Install the Vellaci sidecar — Download from your dashboard → run the .dmg → drag into Applications. Signed and notarised.
- Grant Full Disk Access — System Settings → Privacy & Security → Full Disk Access → toggle Vellaci on. macOS requires this to read chat.db.
- Sign in — Open the sidecar, click 'Connect to my Vellaci'. Browser opens a Clerk auth flow. 30 seconds.
- Map handles to contacts — Vellaci finds handles already in your address book. For unknowns, drag them onto the right contact in the dashboard.
- Choose what to log — Default: metadata only. Optional: enable 'log body' for selected contacts (off by default for privacy).
- Verify a test message — Send yourself a message from another device. Vellaci dashboard should show the new log within 30 seconds.
Privacy
The Vellaci macOS sidecar reads chat.db locally on your Mac (read-only). By default only metadata syncs to the cloud — never the message body. iCloud is not touched.
What this unlocks
- Personal chat is now part of your relationship timeline.
- Auto-log close family / friends without ever opening the app.
- Conversation last-touch tracked without a single button press.
iMessage support across personal CRMs
| Tool | iMessage support |
|---|---|
| Vellaci | Full |
| Dex | No |
| Monica | No |
| Clay | No |
| Cloze | Partial |
| Notion CRM | No |
FAQ
Is the iMessage integration safe?
The Vellaci macOS sidecar reads chat.db locally on your Mac (read-only). By default only metadata syncs to the cloud — never the message body. iCloud is not touched.
What gets logged?
Sender / receiver handles (phone, email); Timestamp of each message; Conversation thread identifier; Message direction (incoming / outgoing); Optional: message body if you opt in explicitly.
How long does setup take?
Around 5 minutes start to finish.
Can I use Vellaci without iMessage?
Yes. Every integration is optional. Most users connect 2-3 of: Gmail, Google Calendar, iMessage, LinkedIn.
