#memory

Add text to the end of an existing memory, on a new line, for an explicit user request such as "add this to my Lisbon note". Never changes or removes existing text. Identify the memory by id (from search_memories or get_memory) or by the externalRef of a note this connection saved. Works on notes the user wrote in the app, except encrypted, read-only or deleting ones (memory_locked). Shared notes require explicit “Add to shared notes” consent; otherwise outside_grant asks the user to reconnect. Additions are visible to people with live access; a connection approved before this was allowed answers outside_grant and the user must reconnect #memory. An identical retry within five minutes is not applied twice. The result must stay within 10,000 characters.

append_to_memory

Attach files or photos from this conversation to an existing memory, for an explicit user request such as "save this PDF to my Lisbon note". Pass the conversation's files in files (up to 10, 50 MB each); never paste file contents into a note instead. Identify the memory by id (from search_memories or get_memory) or by the externalRef of a note this connection saved; to file something new, save_memory first and attach to the note it returns. Encrypted, read-only and deleting notes are refused. Shared notes require “Add to shared notes” consent; additions are visible to their existing live audience. A connection approved before the required access was allowed answers outside_grant. Files that cannot be stored (too large, storage limit, unreachable) are listed in failed while the rest attach. If your client gives you no download_url for the user's files (Claude, for example, cannot pass uploaded files to tools), do not call this tool and do not suggest another upload route: give the user https://www.usememory.com/m/<memory id>, which opens that note in the #memory web app, signed in, where they can drop the files. For several notes saved together that all carry the same keywords, give one link instead, https://www.usememory.com/m?k=<those common keywords, space-separated and URL-encoded>, which lists them all; if they have no keyword in common, give each note its own link. A file the user shares as a public https link can be attached by passing that link as download_url. For a connected Dropbox file, use attach_dropbox_file.

attach_file

List keyword vocabulary and counts within permitted memories for keyword discovery. Returns nextOffset for pagination. Keywords can contain literal commas; this read operation does not rename or split keywords.

list_keywords

Browse permitted memories for library browsing or synchronization, newest updates first. Accepts the previous nextCursor as cursor for pagination. updatedSince is an overlapping polling window, not a deletion/change feed.

list_memories

For an explicit request, create a 14-day frozen copy link or a live public link that expires in 14 days or never. Anyone with the URL can access the shared content. A copy already delivered cannot be retracted; a public link can be stopped.

create_memory_link

Accept irreversible deletion of an integration-created plain text memory by externalRef for an explicit user deletion request. accepted means durably queued; cleanup may finish in the background. Memories with attachments or sharing are ineligible. This cannot be undone.

delete_memory

Show current source posts and public links for one owned memory within this connection’s keyword access. Public-link follower identities are never returned. Copy links are immutable snapshots and are not listed.

list_memory_shares

List up to 100 groups and channels this account can post to. To share with a person, use their exact email address instead. A truncated result may omit destinations.

list_share_destinations

For an explicit request, post an accessible owned memory to an existing group or channel. Use a sourceId the user selected after checking destinations. Group members or channel followers may see the content.

post_memory_to_source

Read one permitted memory by UUID or externalRef (exactly one). Returns its content, keywords, timestamps, access flags and a list of its attachments (photos and files; view one with get_attachment). Encrypted content is returned locked with an empty body. Inaccessible or missing identifiers return not_found.

get_memory