Skip to content
Docs menu

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.

View .md

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

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.