delete_entities
Remove user, agent, app, or run records and their associated memories from the Mem0 MCP Server to manage data and maintain system organization.
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. |
Implementation Reference
- src/mem0_mcp_server/server.py:416-451 (handler)The main handler function for the delete_entities tool. It validates the input arguments using DeleteEntitiesArgs, checks if at least one entity ID is provided, and calls the Mem0 client's delete_users method to perform the deletion.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 schema defining the input parameters for the delete_entities tool, including optional IDs for user, agent, app, and run.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)The @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)." )