add_memory
ChatGPTSave a memory in the user's ACTIVE space. The target space is the one the user selected via select-space; pass namespace only to override it. To remove outdated information, use the separately exposed forget_memory tool. Legacy action='forget' remains supported for existing clients.
fetch-graph-data
ChatGPTFetch documents with memories for graph display
forget_memory
ChatGPTForget a memory matching the supplied content in the user's ACTIVE space. Use when information is outdated or the user asks to remove it. The target space is the one selected via select-space; pass namespace only to override it.
getDocument
ChatGPTDeprecated: use get_document.
get_document
ChatGPTRead one stored document by ID from one space, including its summary and available content. Use list_documents to discover document IDs. When the document is in a named space, resolve it with list_spaces and pass namespace; otherwise use the active space.
get_profile
ChatGPTGet the stable and recent profile for one space — long-lived facts plus recent context. search_memory does not include this. After searching, call this if matching memories are not enough and you need who-the-user-is, preferences, or recent context. When the user names a space, resolve it with list_spaces and pass namespace; otherwise use the active space. Use who_am_i for account identity and access, not profile facts.
guided-save
ChatGPTOpen an interactive form when the user wants to draft, review, edit, or choose the target space before saving information to Supermemory. Use this when the user wants to add a memory but has not supplied final content, or explicitly wants to review supplied content before saving. If the user provides the exact content and asks to save it immediately, use add_memory instead.
listDocuments
ChatGPTDeprecated: use list_documents.
listMemories
ChatGPTDeprecated: use list_memories.
listSpaces
ChatGPTDeprecated: use list_spaces.
list_documents
ChatGPTList documents in one space with their IDs, titles, types, processing status, dates, and summaries. This does not return full document content; use get_document with an ID from this result to read one document. When the user names a space, resolve it with list_spaces and pass namespace; otherwise use the active space.
list_memories
ChatGPTList the latest extracted memory entries in one space, including stable memory IDs and version information. This lists memories directly, not documents. When the user names a space, resolve it with list_spaces and pass namespace; otherwise use the active space. Use search_memory instead for semantic recall.
list_spaces
ChatGPTList the spaces available to the user. Returns each space's key, description, document/memory counts, and last update. Use this first to resolve a named space before calling a space-aware tool, or when the user asks which space may contain something. The list is auto-filtered to spaces the user can access.
memory-graph
ChatGPTRender a space's memory graph directly as an interactive MCP App. This tool is the final visualization; do not create another graph, file, or artifact unless the user explicitly asks for one. If the user names a space, call list_spaces to resolve its key and pass it as namespace. If the user does not name a space, call this tool directly and omit namespace; the server uses the active space or account default. Do not open the space picker unless the user asks to change their active space.
prepare-file-upload
ChatGPTPrepare a direct file upload
save-memory
ChatGPTSave content to memory
search_memory
ChatGPTSearch memories in one space with a natural-language query. Returns matching memories only — not the space profile. If you need who-the-user-is, preferences, or recent context after searching, call get_profile. When the user names a space, resolve it with list_spaces and pass namespace; otherwise use the active space.
select-space
ChatGPTOpen an interactive picker to choose or change the active Supermemory space used for future actions. Use this only when the user asks to switch, select, or change their active or default space. Do not use it merely because the user names a space for a search, list, graph, save, or upload; resolve that space with list_spaces and pass namespace to the relevant tool instead.
set-active-tag
ChatGPTSet the active Supermemory space for this account
upload-file
ChatGPTOpen Supermemory's interactive file picker whenever the user wants to upload, import, or add any local file to Supermemory. Call this tool immediately even when the user only says they want to upload a file. Do not ask for a file path, folder, filename, or filesystem access; the picker handles file selection. It supports documents, text, spreadsheets, images, audio, and video.
whoAmI
ChatGPTDeprecated: use who_am_i.
who_am_i
ChatGPTGet the current Supermemory account context, including user identity, role, access type, permissions, scope, and active space. Use this when the user asks who they are, what access they have, or which space is currently active. Use list_spaces instead when the user asks which spaces are available.
