delete_all_memories
Clear all stored memories for a user, agent, app, or run while preserving the entity structure in the Mem0 MCP Server.
Instructions
Delete every memory in the given user/agent/app/run but keep the entity.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_id | No | User scope to delete; defaults to server user. | |
| agent_id | No | Optional agent scope to delete. | |
| app_id | No | Optional app scope to delete. | |
| run_id | No | Optional run scope to delete. |
Implementation Reference
- src/mem0_mcp_server/server.py:340-369 (handler)Handler and registration for the delete_all_memories tool. Uses DeleteAllArgs schema, resolves settings, prepares payload, and calls Mem0 client's delete_all method.@server.tool( description="Delete every memory in the given user/agent/app/run but keep the entity." ) def delete_all_memories( user_id: Annotated[ Optional[str], Field(default=None, description="User scope to delete; defaults to server user.") ] = None, agent_id: Annotated[ Optional[str], Field(default=None, description="Optional agent scope to delete.") ] = None, app_id: Annotated[ Optional[str], Field(default=None, description="Optional app scope to delete.") ] = None, run_id: Annotated[ Optional[str], Field(default=None, description="Optional run scope to delete.") ] = None, ctx: Context | None = None, ) -> str: """Bulk-delete every memory in the confirmed scope.""" api_key, default_user, _ = _resolve_settings(ctx) args = DeleteAllArgs( user_id=user_id or default_user, agent_id=agent_id, app_id=app_id, run_id=run_id, ) payload = args.model_dump(exclude_none=True) client = _mem0_client(api_key) return _mem0_call(client.delete_all, **payload)
- src/mem0_mcp_server/schemas.py:72-79 (schema)Pydantic input schema DeleteAllArgs for validating parameters of delete_all_memories tool.class DeleteAllArgs(BaseModel): user_id: Optional[str] = Field( None, description="User scope to delete; defaults to server user." ) agent_id: Optional[str] = Field(None, description="Optional agent scope filter.") app_id: Optional[str] = Field(None, description="Optional app scope filter.") run_id: Optional[str] = Field(None, description="Optional run scope filter.")