---
title: Mention People contacts in Notes
description: Type @ in a note to mention a contact from Venom People, see the notes that mention a person on their page, log a note as a meeting, and how agents read a mention.
section: cloud
order: 163
audience: [user, agent, builder]
sources: [services/nodejs-cloud/lib/globe/person-mention.ts, services/nodejs-cloud/lib/people/autolink.ts, services/nodejs-cloud/lib/globe/mcp/index.ts, services/nodejs-cloud/lib/people/mentions.ts, services/nodejs-cloud/lib/people/member-link-model.ts, services/nodejs-cloud/components/globe/editor/mentions.tsx, services/nodejs-cloud/components/globe/editor/person-card.ts, services/nodejs-cloud/app/api/workspace/people/mentions, services/nodejs-cloud/migrations/0174_people_meeting_notes.sql, docs/adr/0057-venom-people.md]
features: [cloud.page-people, cloud.people, cloud.api-workspace, cloud.migrations]
---

Venom People keeps who you know; Notes keeps what you write. A mention connects them, so a note about a meeting shows up
on the person, and the person's page knows which notes talk about them.

## Mention a contact

In a note type `@` and a name. The menu lists org members under **Members** and your People contacts under
**People** (a bare `@` offers your most recently changed contacts). Picking a contact inserts a chip. Hover it for a card
with their name, role, company and, for people you know yourself, when you last talked.

Clicking a chip opens the person's page in People. An org member's chip (`@joel`) opens their People record, matched by
email or verified phone, or offers to add them: see [Opening a person](/docs/cloud/people.md#opening-a-person). While you read a
note, the page opens in the same tab. While you edit, a click on the chip opens it in a new tab so the note stays open
with the caret where it was, the same way the live `[[ENG-1]]` issue chip works. `Cmd`-click or `Ctrl`-click always opens
a new tab. To remove a mention, put the caret after it and press `Backspace`. People's own fields link people the same
way: see [Linking people](/docs/cloud/people.md#linking-people). Mentions in Notes comments link the same way. Only people you may see are offered: a person a colleague shared with you shows who they are and nothing private.

## Mentioned in

A person's page lists, under **Mentioned in**, the notes that mention them, newest first, with the title, the date
and a line of context. You only see notes you can read: your own, the organisation's, and your teams'. **Log as a
meeting note** adds a meeting to their timeline that links to the note, once per note; if the note is later deleted the
timeline keeps the entry and drops the link.

## How it is stored

A mention is the editor's mention span with the kind `person` and the contact's People id, which does not change when the
person is renamed:

```html
<span data-mention="person" data-id="018f3a2e-1111-7222-8333-444455556666">@Sarah Chen</span>
```

An org member stays `data-mention="user"` with their id, exactly as before. The label is only what was shown when it was
written; the chip draws the current name. In Obsidian the span reads as `@Sarah Chen`. Anything that reads note bodies can
find a person's mentions by the exact text `data-mention="person" data-id="<id>"`, which is what **Mentioned in** does.

A People company is the same span with the kind `company` and the company's id. Its chip opens the company's page
(`/people/companies/<id>`):

```html
<span data-mention="company" data-id="018f3a2e-2222-7222-8333-444455556666">@Poddster</span>
```

## Mention anything else

The same `@` menu offers the rest of the workspace under its own headings: projects, deals, agent chats, computers,
cycles, initiatives, incidents, support conversations, forms, flags, experiments, bookings and chat channels you can
see. The span has the item's kind (`data-mention="deal"`) and its id, and the chip shows the item's current title, or,
for a reader who can't see it, the written label greyed out with a lock. Saving the note links it to every contact,
company and item it mentions (relation `mentions`), so their **Linked** sections list the note. Org members are not
linked. See [Mentions](/docs/cloud/references.md#mentions).

## Automatic links

When an agent writes through MCP, names you already keep in People become links without anyone typing `@`:

- `globe_note_write` (create, append, replace) and `globe_note_edit` turn the first time each contact or company is
  named in the new text into a chip. Someone the note already links is not linked again.
- `people_person_create`, `people_person_update` (how you met, notes) and `people_interaction_create` (the summary) turn
  the people a text names into pills, as in [Linking people](/docs/cloud/people.md#linking-people). The person the text is about is
  never linked to themselves. People's text fields have no company pill, so companies stay plain there.

A contact needs their full name (two words or more, any case). A company needs a name of three or more characters,
written with the same case; a one-word company name must start with a capital or a digit. A name two of your contacts
or companies share is left alone, since the link would be a guess. Only contacts you may see are linked, and any company
of the organisation. Nothing inside code, a link, a URL or email address, an HTML tag, a heading, a quote or a callout is
changed: quoted text is usually someone's own words.

The tool's answer lists what it linked (`Linked: @Will Robinson (person), @Poddster (company).`). Pass
`link_mentions: false` to write the text exactly as given. No model is called: names are matched against your People
records in one lookup.

## Agents

- `globe_note_get` lists the People contacts and companies a note mentions at the end of its answer (name and id;
  `format: json` has `people` and `companies` arrays). Read one with `people_person_get` or `people_company_get`.
- Every tool that creates a note, a person or an issue answers with its page's `url`: `globe_note_write`,
  `people_person_create`, `people_capture_create`, `people_interaction_create` (the person's page) and
  `tasks_issue_create`. Show it to the person you are working for.
- `people_interaction_create` adds a note or a meeting to one of your people, with `place` and `globe_note` (the id of a
  note it points at). There is no separate note tool: a note is an interaction of kind `note`.

The browser's own routes behind the menu and the cards are `GET /api/workspace/people/mentions?q=` (contacts) and
`?ids=` (cards); they answer only with what People's sharing rules let the signed-in member see.
