Sources

Your contacts and relationship history, in one local book. See what each source imports and what you need to connect it.

Contacts and messaging

Apple Contacts

Ready

macOS · Full Disk Access may be required

Reads the Mac's local Address Book as a consistent contact snapshot.

Details and limits for Apple Contacts

Each Apple contact is authoritative. Two Apple cards that share a field stay separate until a person reviews them.

Import path
Local database
Includes
Contacts, Structured fields, Local reconciliation

iMessage

Ready

macOS · local Messages database

Builds interaction history from content-free Messages metadata already on the Mac.

Details and limits for iMessage

Only exact normalized email or phone handles can link. Message bodies are never read.

Import path
Local metadata
Includes
Interaction counts, Reciprocity, Last contact

Google Contacts

Ready

Google contact scopes · Ghostget authorization

Syncs saved Contacts and Other contacts as separate, fully paginated collections.

Details and limits for Google Contacts

The contact-only projection never scans Gmail or reads message bodies.

Import path
Official API via Ghostget
Includes
Saved contacts, Other contacts, Dates and events

Beeper

Ready

Beeper Desktop and pinned CLI on macOS or Linux

Imports account-aware contacts and stages bounded contact or conversation candidates for explicit review.

Body-free interaction counts · macOS arm64 only

Details and limits for Beeper

Read-only in PeopleBlade. It never sends messages or imports message bodies, attachments, reactions, media, credentials, or local paths.

Import path
contacts.search@1 via pinned official Beeper CLI 0.6.2 · contacts.list@3 + messaging.search@2 via fixed Desktop-loopback reads
Includes
Contacts, Candidate search
contacts.search@1
Pinned official Beeper CLI 0.6.2
contacts.list@3
Fixed Desktop-loopback read
messaging.search@2
Fixed Desktop-loopback read

Body-free interaction counts. Separate bounded exporter 1.1.0; complete one-to-one conversations only, so counts may understate history.

Ghostget 0.18.13 · adapter 2.4.0 · Beeper CLI 0.6.2

Contact imports use Ghostget's beeper-local adapter. Interaction counts are optional. Ghostget supports broader Beeper messaging and actions; PeopleBlade exposes none of those mutations.

WhatsApp

Ready

User-approved linked-device pairing

Syncs exact account-scoped contacts and lower-bound interaction metadata.

Details and limits for WhatsApp

Display-name overlap never merges identities; a shared exact phone joins records only through a recorded identity decision. Message bodies are not imported.

Import path
Linked device via Ghostget
Includes
Contacts, Interaction counts, Linked-device sync

Your data exports

LinkedIn

Ready

Owner-supplied LinkedIn ZIP

Imports connections and body-free message-participant metadata from the official ZIP export, then reads one imported connection's Contact info through Ghostget from your signed-in browser profile.

Details and limits for LinkedIn

Exact member profile URLs anchor identities. Names alone never do. Connection lists are never collected from a signed-in browser.

Import path
Official data archive
Includes
Connections, Exact profiles, Message participants, Contact info

Instagram

Ready

Owner-supplied Accounts Center JSON archive

Imports reviewed relationship, message-participant, and synced-contact paths from Accounts Center JSON.

Details and limits for Instagram

Archive records may be structurally parsed and integrity-hashed; message text is not retained. Names alone remain unresolved.

Import path
Official data archive
Includes
Relationships, Participants, Synced contacts

X data archive

Bounded metadata

Owner-supplied X data archive

Builds a graph from account, follower, following, and body-free interaction coordinates.

Details and limits for X data archive

Unresolved numeric peers stay inert evidence. Post and direct-message bodies are not persisted.

Import path
Official data archive
Includes
Followers, Following, Body-free graph metadata

Not available yet

X live mutuals

Blocked safely

Unavailable until a bounded Ghostget route exists

Reserved for a future bounded, account-bound mutual-follow capability.

Details and limits for X live mutuals

No API or scraping fallback exists while an exact reviewed Ghostget operation is unavailable.

Import path
Not enabled
Includes
No live import

Telegram

Validation pending

Unavailable pending a real export fixture

A strict Telegram Desktop JSON importer is designed but not yet enabled.

Details and limits for Telegram

Support waits for validation against a real owner-supplied export artifact.

Import path
Not enabled
Includes
Artifact validation TODO

After import

The full book stays local. Your graph lives in SQLite on your machine. Optional cloud sync sends a bounded projection.

Matching takes evidence. Exact provider coordinates can anchor a person. Names, fuzzy candidates, and unverified handles cannot.

Every import is inspectable. Each run records its source, completeness limits, and implementation version.

Package availability

Public CLI · npm 0.4.1