A B16 downloadsSync contacts from Microsoft 365 (or import CSV/vCard) and autocomplete them as links. A minimal person note is created the first time you mention someone.
An Obsidian plugin that turns your contacts into person links. It syncs from Microsoft 365 (your Outlook contacts and the people you work with), from Google (your Google contacts and the people you email in Gmail), or both, and it can import a CSV or vCard file. When the same person turns up in more than one place, the copies are merged into one suggestion. As you type, the plugin suggests people, and picking one inserts a link. The first time you link someone, a minimal person note is created, so links, aliases and backlinks all work the way Obsidian normally does.
| Goal | How |
|---|---|
| Autocomplete | Suggestions come from the synced and imported contacts and the notes in your people folder. Typing soren finds "Søren", sj finds Søren Jensen, and nicknames and aliases match too. People you pick often rank higher. |
| Aliases | An Outlook nickname becomes an alias. Aliases you add yourself to a person note's aliases: are picked up automatically. If you type an alias, the link becomes [[Full Name|alias]]. |
| Links | The first time you pick someone, People/Full Name.md is created with only frontmatter (aliases, email, company, role). From then on the person is a real note, with graph node, backlinks and rename support. People you never mention never get a file. |
[[ after 2 characters, when the text matches a person's name or alias. If nothing matches, or you press Esc, Obsidian's own note suggestions take over.@ anywhere in text, for example @søren je → [[Søren Jensen]]. The @ is replaced. This doesn't trigger inside email addresses or inline code.The link follows your vault's link settings (wikilink or Markdown, path format).
The plugin signs in to Microsoft the same way as the Outlook Calendar Panel and Microsoft To Do Panel plugins: an OAuth device code, your own Microsoft Entra app registration, and a session kept in Obsidian's secret storage on your device, outside the vault. Access is read-only.
It syncs two sources, and you can turn either off:
/me/contacts, permission Contacts.Read)./me/people, permission People.Read): colleagues and people you email, ranked by Microsoft by how much you work with them, 500 by default. The ranking also lifts them in suggestions.A sync runs shortly after Obsidian starts and then every 12 hours (you can change this). You can also use Sync now in settings or the command Contact Links: Sync contacts now, which syncs every account you're signed in to. Each sync replaces the contacts previously synced from that account; contacts from the other account and from files are kept. Signing out of an account removes the contacts synced from it; person notes are kept.
Each plugin keeps its own sign-in, so you sign in once here even if the other plugins are already signed in.
The plugin signs in with your own Google Cloud OAuth client. Access is read-only. It syncs two sources, and you can turn either off:
people/me/connections, scope contacts.readonly).otherContacts, scope contacts.other.readonly): people you've emailed in Gmail but never saved. Only the ones with a name are used. If Google refuses one of the two lists (for example because a permission was left unticked when you signed in), the other is still synced and the settings show what failed.Signing in to Google works in Obsidian on desktop only. Google doesn't allow the contacts permissions in the code-on-another-device flow that Microsoft uses, so the browser returns to a short-lived listener on 127.0.0.1. Contacts synced on desktop still reach your phone with the vault.
contacts.readonly and contacts.other.readonly.The client secret and the session are kept in Obsidian's secret storage on your device, not in the vault.
With more than one source, the same person often shows up twice. Contacts are merged when:
The merged contact keeps the name and nickname from the first source in this order: Microsoft 365, Google, files. Its email addresses are combined, company and job title come from the first source that has them, and the Microsoft relevance rank is kept. No-reply and notification senders (noreply@, notifications@, GitHub reply addresses and the like) are left out of every source.
Merging happens only in memory: each account's contacts are stored as synced, so signing out or turning a source off never leaves half a merge behind.
Both CSV and vCard (.vcf) files work. That includes English and Danish column headers, comma or semicolon separators, UTF-8 or Windows ANSI encoding, and Outlook's vCard 2.1 quoted-printable format. Importing again updates contacts by email address; it doesn't create duplicates.
If a contact has no note in the people folder, but a link to their full name already opens a note somewhere else (say Colleagues/Søren Jensen.md), that note is used as their person note. Suggestions link to it and the panel opens it, so no second note with the same name is created. This uses Obsidian's own link resolution and only reads your notes. To stay on the safe side, it applies only to full names of two or more words, skips a note whose email belongs to someone else, and never uses one note for two contacts. You can turn it off under Use existing notes outside the folder.
Nothing is moved unless you ask:
Moving uses Obsidian's rename, so links to the notes keep working. Right-click → Add contact details to note fills in the email, company, role and nickname a note is missing, and changes nothing else.
The contact icon in the ribbon, or the command Contact Links: Open contacts panel, opens a list of everyone the plugin knows in the right sidebar, with a search field that stays at the top. Each row shows where the person comes from (Microsoft, Google, File), whether they have a note, and their role, company and email.
| Setting | Default |
|---|---|
| Microsoft 365: saved contacts / people you work with | on / on (500 people) |
| Google: saved contacts / other contacts | on / on |
| Merge people with the same name | off |
| Use existing notes outside the folder | on |
| Sync every | 12 hours |
| People folder | People |
| Create a note on first mention | on |
| Show the alias you typed | on |
Inside [[ ]] |
on, minimum 2 characters |
| Mention trigger | @ |
| Suggest on plain names | off, minimum 3 characters |
npm install
npm test # unit tests for import, mapping, deduplication, matching and trigger detection
npm run build # type-check and bundle to main.js
npm run dev # rebuild on change
To install, copy main.js, manifest.json and styles.css into <vault>/.obsidian/plugins/outlook-contacts-autocomplete/, then enable the plugin under Community plugins.
src/core/ and has no Obsidian dependency, so it can be unit-tested.[[ relies on Obsidian internals: the ordered workspace.editorSuggest.suggests list, where the first suggester to trigger wins. Tab to accept relies on the popover's suggestions.useSelectedItem. Both were checked against the Obsidian 1.15.1 app bundle. If a future version changes them, the @ trigger keeps working, and Tab falls back to its normal behaviour.data.json in the vault. If your vault is in Git, consider ignoring that file. The Microsoft and Google sessions and the Google client secret are never stored in the vault.