Mention People contacts in Notes
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.
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. 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. 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:
<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>):
<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.
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) andglobe_note_editturn 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) andpeople_interaction_create(the summary) turn the people a text names into pills, as in 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_getlists the People contacts and companies a note mentions at the end of its answer (name and id;format: jsonhaspeopleandcompaniesarrays). Read one withpeople_person_getorpeople_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) andtasks_issue_create. Show it to the person you are working for. people_interaction_createadds a note or a meeting to one of your people, withplaceandglobe_note(the id of a note it points at). There is no separate note tool: a note is an interaction of kindnote.
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.