---
title: Notes pages for agents (trash, versions, sharing, comments, inbox)
description: 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.
section: cloud
order: 163
audience: [user, builder, agent]
sources: [services/nodejs-cloud/lib/globe/mcp/social.ts, services/nodejs-cloud/lib/globe/mcp/social-routes.ts, services/nodejs-cloud/lib/globe/mcp/pages.ts, services/nodejs-cloud/lib/globe/mcp/pages-routes.ts, services/nodejs-cloud/lib/globe/mcp/xtool.ts, services/nodejs-cloud/lib/mcp/parity.ts]
features: [cloud.workspace]
---

Everything a person does to a Notes page in the app has a tool on the [workspace MCP server](/docs/cloud/workspace-mcp.md)
(`/workspace/mcp`, or `/workspace/mcp/globe`) and a path under `/api/v1` ([REST API](/docs/developers/rest.md)). 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](/docs/globe/move-between-vaults.md)). `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](/docs/cloud/globe-databases-mcp.md): `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.

```json
{ "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](/docs/cloud/mcp-files.md).

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