Notes pages for agents (trash, versions, sharing, comments, inbox)
Notes tools beyond reading and writing notes, on the workspace MCP server and its REST twin. Trash, versions, publishing, sharing, links, favourites, comments, the Inbox, sources, files, settings, imports and database templates.
Everything a person does to a Notes page in the app has a tool on the workspace MCP server
(/workspace/mcp, or /workspace/mcp/globe) and a path under /api/v1 (REST API). The tools call
the same functions the app calls, so the same access rules, add-on check, audit log and version history apply: a
note someone else cannot read answers "No such ... or not one you can read" over MCP and 404 over REST.
Arguments are checked against each tool's own schema, an unknown argument is refused by name, and writes that change
something that exists take expect_version where it makes sense. A connected app without globe:write is refused
every write.
Trash and versions
| Tool | Does | Example |
|---|---|---|
globe_note_delete |
Move a note to the trash (30 days) | {"id":"<note id>"} |
globe_trash_list |
The trash of a vault, optionally filtered by path text | {"vault":"me","q":"plan"} |
globe_note_restore |
Bring a trashed note back to its path, or a free name beside it | {"id":"<note id>"} |
globe_trash_purge |
Delete a trashed note for good | {"id":"<note id>"} |
globe_version_list |
Saved versions of a note, newest first | {"id":"<note id>"} |
globe_version_restore |
Put an earlier version back (the current text is kept as a version) | {"id":"<note id>","version":"<version id>"} |
REST: POST /notes/{id}/trash, GET /trash, POST /trash/{id}/restore, POST /trash/{id}/purge,
GET /notes/{id}/versions, POST /notes/{id}/versions/{version}/restore.
Freshness, publishing and sharing
| Tool | Does |
|---|---|
globe_note_freshness, globe_note_confirm |
When a note was last confirmed and whether it is stale; mark it checked |
globe_note_publish_get, globe_note_publish, globe_note_unpublish |
A note's public link: read, publish (indexable, rotate), take offline |
globe_share_list, globe_share_create, globe_share_delete |
Who a note is shared with; invite a member by email or a group by team at view, comment or edit; remove an invite by uid |
globe_share_update |
Restrict an org note to the people invited (restricted: true), or open it again (org:manage) |
globe_shared_list |
Notes other members shared with you |
Links, folders, favourites
globe_link_resolve finds the note a [[link]] points at the way the editor does (by path, title or alias).
globe_graph_get returns the notes of a vault and the links between them. globe_folder_move renames or moves a folder
with all its notes and rewrites the links to them. globe_note_move moves notes or folders into another vault (links,
files and databases follow; globe_note_move_preview says who gains or loses access first, globe_note_move_undo
puts a move back; see Move notes between vaults). globe_favorite_list and globe_favorite_set (the whole list, in
order) read and write your favourites; globe_dashboard_list lists the pages that hold live Experiments insights.
Database leftovers
For Notes databases: globe_database_export returns the .base file;
globe_automation_list the log of an automation's runs (globe_database_update takes automations to replace
them); globe_template_list, globe_template_create, globe_template_update and globe_template_delete manage row
templates (preset values by property name, a title pattern, a body); globe_row_apply fills a row's empty cells from a
template; globe_row_press presses a Button property.
{ "name": "globe_template_create", "arguments": { "database": "Tasks", "name": "Bug", "title": "Bug {{weekday}}", "values": { "Status": "Todo" }, "body": "## Steps" } }Comments and notifications
| Tool | Does | Example |
|---|---|---|
globe_comment_list |
A note's threads with replies and reactions | {"id":"<note id>"} |
globe_comment_create |
A new thread (page, or inline on quoted text), or a reply with thread; @[name](user:<uid>) mentions notify |
{"id":"<note id>","body":"Cite this?","kind":"inline","quote":"revenue grew 12%"} |
globe_comment_update, globe_comment_delete |
Edit your comment; delete a comment (a thread when its first one goes) | {"comment":"<id>","body":"Reworded"} |
globe_comment_react |
Toggle your emoji on a comment | {"comment":"<id>","emoji":"👍"} |
globe_comment_resolve |
Resolve or reopen a thread | {"thread":"<id>","resolved":true} |
globe_notification_list, globe_notification_read |
Your mentions and replies, unread count; mark read (all, or one note) | {"limit":20} |
Comments are written by members: a team or service key reads threads but cannot comment.
The Inbox, sources and files
globe_suggestion_list shows the suggestions waiting in a vault (from the loop, agents and people);
globe_suggestion_apply (optionally with edits), globe_suggestion_reject, globe_suggestion_undo and
globe_suggestion_apply_all decide them. globe_suggestion_create files new ones. globe_source_create keeps text
verbatim as a source for the loop to connect to your notes, globe_source_list and globe_source_get read them.
globe_file_upload stores a file in a vault and answers the link to put in a note (with note, it adds it to the end of
that note). It takes an upload_id from globe_file_prepare after a curl -T of the raw bytes, a public url Venom
fetches, or, for small files under about 50 KB, base64. globe_file_get shows a file, or the pictures in a note, as
pictures the model sees, with a short-lived download URL for each. See Files and pictures over MCP.
Synced blocks, settings and imports
globe_synced_list lists the notes that hold a copy of a synced block and globe_synced_unsync turns every copy into
plain text. globe_setting_get and globe_setting_update (needs org:manage) read and change the loop's daily spend cap
and whether session summaries and org memory are mirrored. globe_import_list shows the chat-history import's status;
globe_conversation_import queues up to 25 conversations read from a ChatGPT or Claude export, and globe_page_import
writes a batch of notes and databases read from a Notion export or a markdown folder. A whole-vault zip export or
import is not a tool: list and read notes with globe_note_list and globe_note_get, write them with
globe_note_write or globe_page_import.