People Atlas

by kayacancode
5
4
3
2
1
Score: 49/100

Description

Obsidian plugin — lightweight CRM from Gmail metadata + Harper Skill AI people enrichment

Reviews

No reviews yet.

Stats

1
stars
239
downloads
0
forks
1
days
1
days
1
days
20
total PRs
4
open PRs
0
closed PRs
16
merged PRs
1
total issues
0
open issues
1
closed issues
309
commits

Latest Version

a day ago

Changelog

People Atlas 1.0.2

Renames the plugin to People Atlas to meet the community directory naming requirements. Removes a blanket lint-disable comment from generated server types that blocked automated review. Adds a release check preventing names containing the word Plugin.

The plugin ID remains gmail-crm, preserving installed settings and saved data.

README file from

Github

People Atlas

Build a personal CRM in your Obsidian vault from Gmail activity, keep Markdown people notes, and explore your relationships in a People graph tab.

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

This plugin has been submitted to the Obsidian Community directory and is undergoing automated review.

Until approval, download main.js, manifest.json, and styles.css from a plugin release, place them in <vault>/.obsidian/plugins/gmail-crm/, then enable People Atlas under Settings → Community plugins. BRAT remains an optional beta installation method.

After the plugin is approved, install it from Settings → Community plugins → Browse by searching for People Atlas.

Start using it

  1. Open Settings → People Atlas 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 Atlas: Sync contacts from the command palette. Review the generated people notes and relationship scores.
  3. Run People Atlas: 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.

This repository also contains a standalone People web app and 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.