Skip to main content
Free · Your key and project keys
Saves text into the person’s Memory, filed under your tool’s folder (or your project). Every search finds it, from any AI tool they connect. It is not a note: it only shows in their Library if they add it there.
Refused on a read-only sign-in. When the person’s storage is full it says so and saves nothing. See Limits.
Call it at POST /platform/v1/me/tools/memory_add or, for one of your app’s users, POST /platform/v1/users/{uid}/tools/memory_add. On MCP, your AI tool calls memory_add with the same arguments.

Arguments

Send these inside arguments.
string
required
What to remember, in full sentences that make sense on their own. Up to 100,000 characters.
string
default:"\"\""
A short title, up to 300 characters. Leave it out and the first line is used.
string
default:"\"\""
Your own id for this memory: 1-128 letters, digits and . _ : @ -. Save the same id again to replace it, so one memory stays up to date. Leave it out and a new id is made and returned.
string[]
default:"null"
Plain tag names, up to 20 of 60 characters.

Returns

The tool’s answer comes back under result.
string
The memory’s id. Keep it to update or forget the memory later.
string
The folder it was filed under, like agents, claudecode or app + your project id.
boolean
true when a memory with this id was replaced.