mac_unified_logs_security_events
Search macOS Unified Logs for predefined security events (user creation, authentication, process execution, etc.) for digital forensic investigations.
Instructions
Get pre-defined security events from Unified Logs. Event types: user_created, user_deleted, user_modified, ssh_session, sudo_usage, auth_success, auth_failure, process_exec, gatekeeper, tcc_prompt, login, logout, screen_lock, screen_unlock, remote_login, persistence
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"log_path": "<log_path>",
"event_type": "<event_type>"
},
"name": "mac_unified_logs_security_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| offset | No | ||
| log_path | Yes | Path to unified_logs.csv or .logarchive bundle | |
| time_end | No | ISO datetime - filter events before this time | |
| event_type | Yes | Type of security event to search for | |
| time_start | No | ISO datetime - filter events after this time |