Provides access to macOS and iOS system logs, crash reports, and device logs for debugging and monitoring.
Enables streaming and searching logs from connected iOS devices and simulators, including filtering by process and severity.
Allows retrieval and streaming of macOS system logs, with filtering by process, subsystem, and log level.
Facilitates log access from iOS Simulators managed by Xcode, including listing simulators and streaming live logs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@console-mcp get recent logs for com.apple.network"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP (Model Context Protocol) server for streaming and searching macOS Console.app and iOS device logs directly from Claude, GitHub Copilot, or any MCP-compatible AI assistant.
Stream real-time logs, search crash reports, filter by severity, and debug iOS simulators and physical devices — all through natural language.
List Devices - Show connected iOS devices
List Simulators - Show available iOS Simulators
Get Logs - Fetch recent logs filtered by process or subsystem
Get Device Logs - Fetch logs from connected iOS devices
Get Simulator Logs - Fetch logs from iOS Simulators
Get Logs by Level - Filter logs by severity (fault, error, warning, info, debug)
Stream Logs - Capture live logs for a specified duration
Search Logs - Search through historical logs (supports regex)
Get Crash Logs - List and read crash reports
Watch for Pattern - Stream until a pattern matches
Export Logs - Save logs to file for sharing
VPN Logs - Quick shortcut to get WorxVPN-specific logs
Related MCP server: mcp-server-logs-sieve
git clone https://github.com/rohithgoud30/console-mcp.git
cd console-mcp
npm install
npm run buildInstall libimobiledevice for direct iOS device log streaming:
brew install libimobiledeviceAdd to your .vscode/mcp.json:
{
"servers": {
"console": {
"command": "node",
"args": ["/path/to/console-mcp/dist/index.js"]
}
}
}list_devicesList connected iOS devices with their UDIDs.
list_simulatorsList available iOS Simulators.
Parameter | Type | Description |
| boolean | Only show running simulators (default: false) |
| string | Filter by runtime (e.g., 'iOS 17') |
get_logsGet recent logs from macOS.
Parameter | Type | Description |
| string | Filter by process name (e.g., 'Safari') |
| string | Filter by subsystem (e.g., 'com.apple.network') |
| number | Minutes of logs to fetch (default: 5) |
| number | Max lines to return (default: 200) |
get_logs_by_levelGet logs filtered by severity level.
Parameter | Type | Description |
| string | Log level: fault, error, warning, info, debug (required) |
| string | Filter by process name |
| number | Minutes of logs to fetch (default: 5) |
| number | Max lines to return (default: 200) |
get_device_logsGet logs from a connected iOS device. Requires libimobiledevice.
Parameter | Type | Description |
| string | Device name or UDID (required) |
| string | Filter by process name |
| number | Minutes of logs to capture (default: 5, max: 10) |
| number | Max lines to return (default: 200) |
get_simulator_logsGet logs from an iOS Simulator. Simulator must be booted.
Parameter | Type | Description |
| string | Simulator name or UDID (required) |
| string | Filter by process name |
| number | Minutes of logs to fetch (default: 5) |
| number | Max lines to return (default: 200) |
stream_logsStream live logs for a duration.
Parameter | Type | Description |
| string | Filter by process name |
| number | How long to stream (default: 10, max: 30) |
stream_simulator_logsStream live logs from an iOS Simulator.
Parameter | Type | Description |
| string | Simulator name or UDID (required) |
| string | Filter by process name |
| number | How long to stream (default: 10, max: 30) |
search_logsSearch through recent logs with text or regex.
Parameter | Type | Description |
| string | Text or regex pattern to search for (required) |
| boolean | Treat query as regex (default: false) |
| number | Minutes to search (default: 30) |
| number | Max matching lines (default: 100) |
get_crash_logsList recent crash reports from DiagnosticReports.
Parameter | Type | Description |
| string | Filter by process/app name |
| number | Days to search back (default: 7) |
| number | Max reports to list (default: 10) |
read_crash_reportRead the full content of a specific crash report.
Parameter | Type | Description |
| string | Crash report filename (required) |
watch_for_patternStream logs until a pattern matches. Great for test automation.
Parameter | Type | Description |
| string | Text or regex to watch for (required) |
| boolean | Treat pattern as regex (default: false) |
| string | Filter by process name |
| number | Max wait time (default: 30, max: 60) |
export_logsExport logs to a file on the Desktop.
Parameter | Type | Description |
| string | Log content to export (required) |
| string | Optional filename |
| string | Export format: txt or json (default: txt) |
get_vpn_logsShortcut to get WorxVPN extension logs.
Parameter | Type | Description |
| number | Minutes of logs (default: 5) |
| number | Max lines (default: 300) |
// In Copilot chat:
"List my iOS simulators"
"Get logs from iPhone 15 Pro simulator"
"Show device logs from my iPhone"
"Get the last 5 minutes of Safari logs"
"Show me all error logs from the last 10 minutes"
"Search logs for 'authentication' using regex"
"Get crash logs for MyApp"
"Read the crash report MyApp-2024-12-27.crash"
"Watch for 'connection established' while I connect"
"Export these logs to a file"
"Stream logs for 15 seconds while I reproduce the bug"
"Show me WorxVPN logs"macOS 13+ (Ventura or later)
Node.js 18+
Xcode (for simulators and xcrun tools)
libimobiledevice (optional, for iOS device logs)
macOS log command is used for local logs
xcrun simctl is used for simulator logs
idevicesyslog from libimobiledevice is used for iOS device logs
iOS device must be paired and trusted for log access
Crash reports are found in ~/Library/Logs/DiagnosticReports
Exported logs are saved to ~/Desktop/ConsoleMCP-Exports/
Originally created by devstroop. This fork includes custom modifications and enhancements.
MIT
Export logs to a file on the Desktop for sharing
Inputs: logs (required), format, filename.
List recent crash reports from DiagnosticReports
Inputs: process, lastDays, maxReports.
Get logs from a connected iOS device. Requires libimobiledevice (brew install libimobiledevice)
Inputs: device (required), process, maxLines, lastMinutes.
Get recent logs from macOS system. Use for debugging macOS apps.
Inputs: process, maxLines, subsystem, lastMinutes.
Get logs filtered by severity level (fault, error, warning, info, debug)
Inputs: level (required), process, maxLines, lastMinutes.
Get logs from an iOS Simulator. The simulator must be booted.
Inputs: simulator (required), process, maxLines, lastMinutes.
Get logs specifically for WorxVPN extension - filters for VPN-related processes
Inputs: maxLines, lastMinutes.
List connected iOS devices (physical devices connected via USB)
Inputs: no named parameters.
List available iOS Simulators with their state (Booted/Shutdown)
Inputs: runtime, onlyBooted.
Read the full content of a specific crash report
Inputs: filename (required).
Search through recent logs for a specific string or regex pattern
Inputs: query (required), maxLines, useRegex, lastMinutes.
Stream live logs for a specified duration. Useful for capturing logs during an action.
Inputs: process, durationSeconds.
Stream live logs from an iOS Simulator for a duration
Inputs: simulator (required), process, durationSeconds.
Stream logs until a pattern is found. Useful for test automation - start an action, then wait for a specific log message.
Inputs: pattern (required), process, useRegex, timeoutSeconds.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 14 tools
All tools have clearly distinct purposes: devices, simulators, and various log operations (system, device, simulator, crash, VPN, streaming, search, export, pattern watching). No two tools overlap in functionality.
All tool names follow a consistent 'verb_noun' snake_case pattern (e.g., list_devices, get_logs, stream_logs, search_logs). There is no deviation or mixing of conventions.
14 tools is well-scoped for a console/device management server. It provides a comprehensive set of log retrieval, filtering, streaming, and export operations without being excessive.
The tool surface covers the full lifecycle of log management: listing sources, retrieving logs, filtering, streaming, searching, and exporting. Minor gaps like log deletion or clearing are absent, but core workflows are complete.
Hosted iOS app intelligence and creative research MCP server.
Analytics and debugging for your MCP server — explore usage and sessions, then root-cause errors.
An MCP server that provides tools to discover and retrieve podcast episodes transcripts.
An MCP server that provides congressional transcripts
