kayacancode261 downloadsBring Gmail activity, meeting history, and people notes together to understand your relationships, find reasons to reconnect, and explore personal and shared networks.
Make the network you’ve spent years building more useful.
People Data Sync brings context from Gmail, calendar activity, and your people notes into Obsidian. Track how relationships evolve, revisit past conversations, and explore connections through people notes, timelines, and network graphs.
Recency can tell you when a relationship has gone quiet. Context can help you understand why reconnecting might matter. Your judgment determines what happens next.
Keep your people notes in your vault, add your own context, and optionally connect to hosted personal and shared graphs. It’s a foundation for understanding your network and finding more meaningful reasons to connect.
Desktop only. Requires Obsidian 1.15.0 or later. Gmail sync requires a Google account and Google OAuth authorization. The optional hosted People graph requires a separate People sign-in and internet access; shared networks require membership.
Install from Settings → Community plugins → Browse by searching for People Data Sync. You can also open the community listing.
For manual installation, download main.js, manifest.json, and styles.css from a plugin release, place them in <vault>/.obsidian/plugins/gmail-crm/, then enable People Data Sync under Settings → Community plugins. BRAT remains an optional beta installation method.
Opening the hosted graph does not upload your vault. Graph uploads are a separate command and require a configured server and push token. The hosted graph needs an online service; the plugin’s local notes and intelligence workspace are stored in your vault.
Read the complete plugin guide for setup, commands, scoring, and troubleshooting.
gmail.readonly, Calendar event read access, and read-only Google Contacts access. Review the permissions before connecting. Calendar and photo use can be optional in the UI even though their scopes are requested together.127.0.0.1:42813 for the browser callback. The plugin does not install executables or update itself. The separately installed PeopleGraph CLI is optional.See PRIVACY.md for storage, retention, cloud processing, and revocation details. There is no client-side analytics or advertising tracker. Relationship scores are estimates, not proof of closeness, expertise, or willingness to make an introduction.
npm ci
npm run check:release
Release assets are generated in dist/plugin/. The Git tag must exactly match the manifest version, without a v prefix. See the release checklist.
The hosted People app is maintained in the services repository. This repository also contains the optional PeopleGraph CLI: project overview.
MIT. Report problems or request features in GitHub Issues. Please remove tokens, email addresses, private notes, and contact indexes from reports.
Clone with git clone --recurse-submodules (or run git submodule update --init --recursive in an existing clone), then npm ci and npm run check:release. This runs the Obsidian checks and integration tests against the pinned service source.
Hosted services live in people-atlas-services and have their own CI. For local service checks, run npm ci in services/apps/people-graph and services/apps/reconnect-web, then npm run check:services. Service deployments are managed separately.