delete_entities
Remove user, agent, app, or run records and their associated memories from the Mem0 memory system to manage data lifecycle.
Instructions
Remove a user/agent/app/run record entirely (and cascade-delete its memories).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_id | No | Delete this user and its memories. | |
| agent_id | No | Delete this agent and its memories. | |
| app_id | No | Delete this app and its memories. | |
| run_id | No | Delete this run and its memories. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/mem0_mcp_server/server.py:413-451 (handler)Handler function for delete_entities tool, including @server.tool decorator for registration. Validates input with DeleteEntitiesArgs, ensures at least one entity ID is provided, constructs payload, and delegates to Mem0 client's delete_users method.
@server.tool( description="Remove a user/agent/app/run record entirely (and cascade-delete its memories)." ) def delete_entities( user_id: Annotated[ Optional[str], Field(default=None, description="Delete this user and its memories.") ] = None, agent_id: Annotated[ Optional[str], Field(default=None, description="Delete this agent and its memories.") ] = None, app_id: Annotated[ Optional[str], Field(default=None, description="Delete this app and its memories.") ] = None, run_id: Annotated[ Optional[str], Field(default=None, description="Delete this run and its memories.") ] = None, ctx: Context | None = None, ) -> str: """Delete a user/agent/app/run (and its memories) once the user confirms the scope.""" api_key, _, _ = _resolve_settings(ctx) args = DeleteEntitiesArgs( user_id=user_id, agent_id=agent_id, app_id=app_id, run_id=run_id, ) if not any([args.user_id, args.agent_id, args.app_id, args.run_id]): return json.dumps( { "error": "scope_missing", "detail": "Provide user_id, agent_id, app_id, or run_id before calling delete_entities.", }, ensure_ascii=False, ) payload = args.model_dump(exclude_none=True) client = _mem0_client(api_key) return _mem0_call(client.delete_users, **payload) - src/mem0_mcp_server/schemas.py:81-86 (schema)Pydantic BaseModel defining the input schema (arguments) for the delete_entities tool.
class DeleteEntitiesArgs(BaseModel): user_id: Optional[str] = Field(None, description="Delete this user and all related memories.") agent_id: Optional[str] = Field(None, description="Delete this agent and its memories.") app_id: Optional[str] = Field(None, description="Delete this app and its memories.") run_id: Optional[str] = Field(None, description="Delete this run and its memories.") - src/mem0_mcp_server/server.py:413-415 (registration)@server.tool decorator registers the delete_entities function as an MCP tool with its description.
@server.tool( description="Remove a user/agent/app/run record entirely (and cascade-delete its memories)." )