delete_all_memories
Remove all stored memories for a user, agent, app, or run while preserving the entity structure.
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. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/mem0_mcp_server/server.py:343-369 (handler)The core handler function for the 'delete_all_memories' tool. It resolves API key and default user, validates inputs using DeleteAllArgs, constructs payload, and calls the Mem0 client's delete_all method.
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 BaseModel schema defining the input arguments for the delete_all_memories tool, used for validation.
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.") - src/mem0_mcp_server/server.py:340-342 (registration)The @server.tool decorator registers the delete_all_memories function as an MCP tool with its description.
@server.tool( description="Delete every memory in the given user/agent/app/run but keep the entity." )