Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

People Data Sync

kayacancodekayacancode261 downloads

Bring Gmail activity, meeting history, and people notes together to understand your relationships, find reasons to reconnect, and explore personal and shared networks.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates62

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.

Features

  • Create people and company notes from Gmail metadata.
  • Track contact activity, relationship scores, and contacts worth reconnecting with.
  • Explore a local People intelligence workspace and CRM table.
  • Open personal and shared People graphs inside an Obsidian tab.
  • Optionally enrich people notes with Anthropic using your own API key.

Install

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.

Start using it

  1. Open Settings → People Data Sync and connect Google. If the shared OAuth client is unavailable to your account, configure your own Desktop app credentials using the setup guide.
  2. Enable Create contact notes in settings if you want generated Markdown people pages, then run People Data Sync: Sync contacts from the command palette. Review the generated people notes and relationship scores.
  3. Run People Data Sync: View people graph. Choose Sign in using your browser, sign in to People, approve the Obsidian connection, and return to the tab. Select a shared network in the People app if you belong to one.

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.

Accounts, network use, and privacy

  • Google: normal sync requests message metadata, not email bodies. The current OAuth grant is broader: 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.
  • Anthropic, optional: enrichment sends the selected person’s existing note content (including meeting notes), mapped relationships, connected-person names, and Gmail statistics/recent subjects. It uses your API key. Review your notes before enabling it.
  • People on Cloudflare, optional: opening the graph connects to the hosted People deployment (or your configured server). It uses account sessions for private graphs and network membership for shared graphs. Browser handoff requests expire in five minutes; the embedded session lasts up to 24 hours. Explicit graph pushes upload selected contact and relationship data. Cloud features may process data using Workers AI.
  • Custom score server, optional: a configured score endpoint receives contact scores and your configured account identity when you use score push.
  • OAuth credentials, API keys, contact indexes, and notes are stored in the vault’s plugin data or Markdown files. Vault sync and backups may copy these files to other devices or providers. Credentials are not encrypted by this plugin.
  • Google sign-in temporarily listens on 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.

Development

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.

License and support

MIT. Report problems or request features in GitHub Issues. Please remove tokens, email addresses, private notes, and contact indexes from reports.

Development checks

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.

HealthExcellent
ReviewPassed
About
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.
IntegrationsMarkdownVisualization
Details
Current version
1.0.6
Last updated
1 hour ago
Created
8 months ago
Updates
62 releases
Downloads
261
Compatible with
Obsidian 1.15.0+
Platforms
Desktop only
License
MIT
Report bugRequest featureReport plugin
Sponsor
Buy Me a Coffee
Author
kayacancodekayacancode
GitHubkayacancode
  1. Community
  2. Plugins
  3. Integrations
  4. People Data Sync

Related plugins

Custom Frames

Turn web apps into panes using iframes with custom styling. Also comes with presets for Google Keep, Todoist and more.

Maps

Adds a map layout to bases so you can display notes as an interactive map view.

Excalidraw

Visual PKM powerhouse. Create and edit Excalidraw drawings.

Advanced Canvas

Supercharge your canvas experience. Create presentations, flowcharts and more.

BRAT

Easily install a beta version of a plugin for testing.

LanguageTool Integration

Advanced grammar and spell checking, powered by LanguageTool.

ExcaliBrain

An interactive, structured mind-map of your Obsidian vault.

Linter

Format and style your notes. Linter can be used to format YAML tags, aliases, arrays, and metadata; footnotes; headings; spacing; math blocks; regular Markdown contents like list, italics, and bold styles; and more with the use of custom rule options.

Self-hosted LiveSync

Sync vaults securely to self-hosted servers or WEBRTC.

Breadcrumbs

Visualise the hierarchy of your vault using a breadcrumb trail or matrix view.