Skip to content
Docs menu

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.

View .md

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.

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. 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.