delete_memory
Remove stored conversation data from memory by specifying its unique identifier to manage privacy and control stored information.
Instructions
Delete a specific memory by ID
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| memory_id | Yes |
Implementation Reference
- mcp_mitm_mem0/mcp_server.py:366-420 (handler)MCP tool handler function for 'delete_memory'. Registered via @mcp.tool decorator. Calls memory_service.delete_memory and returns deletion status.@mcp.tool(name="delete_memory", description="Delete a specific memory by ID") async def delete_memory(memory_id: str) -> dict[str, str]: """ Permanently delete a specific memory by its ID. ## When to Use - User explicitly requests to forget something ("forget about...", "delete that memory") - Incorrect or misleading information was stored - Outdated memories that are no longer relevant - Privacy concerns or sensitive data removal - Cleaning up test or temporary memories ## Example Usage ```python # Delete after finding incorrect memory memories = await search_memories("API endpoint") # User: "That old endpoint is wrong, delete it" await delete_memory("mem_oldid456") # Delete outdated preference # User: "Actually, forget what I said about tabs vs spaces" await delete_memory("mem_tabpref789") ``` ## Example Response ```json { "status": "deleted", "memory_id": "mem_oldid456", "message": "Memory successfully deleted" } ``` ⚠️ **Caution**: Deletions are permanent and cannot be undone. Always confirm with the user if you're unsure about deleting a memory. Args: memory_id: The unique memory ID to delete (obtained from search_memories or list_memories) Returns: Confirmation dictionary containing: - status: "deleted" on success - memory_id: The ID that was deleted - message: Confirmation message """ try: await memory_service.delete_memory(memory_id=memory_id) logger.info("Memory deleted", memory_id=memory_id) return {"status": "deleted", "memory_id": memory_id} except Exception as e: logger.error("Delete failed", error=str(e)) raise RuntimeError(f"Delete failed: {str(e)}") from e
- MemoryService.delete_memory method: wrapper around Mem0 AsyncMemoryClient.delete, used by the MCP tool handler.async def delete_memory(self, memory_id: str) -> dict[str, Any]: """Delete a specific memory asynchronously. Args: memory_id: ID of the memory to delete Returns: Deletion response """ try: self._logger.info("Deleting memory", memory_id=memory_id) result = await self.async_client.delete(memory_id=memory_id) self._logger.info("Memory deleted", memory_id=memory_id) return result except Exception as e: self._logger.error( "Failed to delete memory", memory_id=memory_id, error=str(e) ) raise