← Tools Reference

Mem0

Mem0 integration (AI, Data). Imported from open-connector.

API key10 toolshttps://api.mem0.ai
POST
mem0_add_memories
Add new memories to Mem0 from messages or direct memory text.

/v1/memories/

21 parameters
ParamTypeRequiredDescription
memorystringoptionalA single memory string to write directly.
messagesarrayoptionalThe list of messages used to generate memory.
user_idstringoptionalThe associated user identifier.
agent_idstringoptionalThe associated agent identifier.
app_idstringoptionalThe associated application identifier.
run_idstringoptionalThe associated run identifier.
org_idstringoptionalAn optional organization identifier.
project_idstringoptionalAn optional project identifier.
metadataobjectoptionalAn arbitrary JSON object returned by Mem0.
custom_categoriesobjectoptionalA map of custom category names to their descriptions.
enable_graphbooleanoptionalWhether graph memory extraction should be enabled for this request.
inferbooleanoptionalWhether Mem0 should infer structured memory from the messages.
async_modebooleanoptionalWhether the write should be processed asynchronously.
output_formatstringoptionalThe response wrapper format version.
versionstringoptionalThe memory extraction engine version.
custom_instructionsstringoptionalAdditional instructions used to guide memory extraction.
immutablebooleanoptionalWhether the created memory should be treated as immutable.
timestampintegeroptionalThe Unix timestamp associated with the memory input.
expiration_datestringoptionalThe expiration date to attach to the created memory.
includesstringoptionalA string list of keywords that should be prioritized.
excludesstringoptionalA string list of keywords that should be excluded.
POST
mem0_get_memories
List memories from Mem0 with v2 advanced filters.

/v2/memories/

5 parameters
ParamTypeRequiredDescription
filtersobjectrequiredThe advanced filter object supported by the Mem0 v2 memories API.
pageintegeroptionalThe page number to request, starting from 1.
page_sizeintegeroptionalThe maximum number of results per page, up to 100.
org_idstringoptionalAn optional organization identifier.
project_idstringoptionalAn optional project identifier.
POST
mem0_search_memories
Search memories in Mem0 with semantic query and optional filters.

/v2/memories/search/

10 parameters
ParamTypeRequiredDescription
querystringrequiredThe natural-language query used for semantic search.
filtersobjectoptionalAn optional advanced filter object.
top_kintegeroptionalThe maximum number of results to return.
rerankbooleanoptionalWhether Mem0 should rerank the initial search results.
thresholdnumberoptionalThe semantic similarity threshold.
fieldsarrayoptionalThe list of fields to return.
keyword_searchbooleanoptionalWhether Mem0 should perform keyword search instead of semantic search.
filter_memoriesbooleanoptionalWhether Mem0 should strictly apply the provided filters.
org_idstringoptionalAn optional organization identifier.
project_idstringoptionalAn optional project identifier.
GET
mem0_get_memory
Get a single memory from Mem0 by memory ID.

/v1/memories/{memory_id}/

1 parameter
ParamTypeRequiredDescription
memory_idstringrequiredThe unique identifier of the target memory.
PUT
mem0_update_memory
Update text or metadata of a Mem0 memory by memory ID.

/v1/memories/{memory_id}/

3 parameters
ParamTypeRequiredDescription
memory_idstringrequiredThe unique identifier of the target memory.
textstringoptionalThe new memory text to store.
metadataobjectoptionalAn arbitrary JSON object returned by Mem0.
DELETE
mem0_delete_memory
Delete a Mem0 memory by memory ID.

/v1/memories/{memory_id}/

1 parameter
ParamTypeRequiredDescription
memory_idstringrequiredThe unique identifier of the target memory.
GET
mem0_get_memory_history
Get the change history of a Mem0 memory by memory ID.

/v1/memories/{memory_id}/history/

1 parameter
ParamTypeRequiredDescription
memory_idstringrequiredThe unique identifier of the target memory.
GET
mem0_get_events
List Mem0 events for the current API key.

/v1/events/

5 parameters
ParamTypeRequiredDescription
event_typestringoptionalFilter events by event type.
start_datestringoptionalThe start date filter, typically in YYYY-MM-DD format.
end_datestringoptionalThe end date filter, typically in YYYY-MM-DD format.
pageintegeroptionalThe page number to request, starting from 1.
page_sizeintegeroptionalThe maximum number of results per page, up to 100.
GET
mem0_get_event
Get a single Mem0 event by event ID.

/v1/event/{event_id}/

1 parameter
ParamTypeRequiredDescription
event_idstringrequiredThe unique identifier of the target event.
GET
mem0_get_users
List user entities from Mem0, optionally scoped by org and project.

/v1/entities/

2 parameters
ParamTypeRequiredDescription
org_idstringoptionalAn optional organization identifier.
project_idstringoptionalAn optional project identifier.