Mac-health-mcp

Mac Health MCP

Asks your Mac what's wrong and provides explanations in plain English. This local, read-only MCP server for macOS offers insights into your Mac's performance and health. Now you can inquire, "Why is my Mac slow?" and receive a clear, ranked list of potential causes, accompanied by straightforward explanations and actionable advice.

Overview

Mac Health MCP functions as a Model Context Protocol server, compatible with clients like Claude Desktop and Claude Code. It effectively checks various aspects of your Mac’s performance including uptime, memory usage, disk space, active processes, Spotlight efficiency, temperature, battery status, and startup items.

Key Features

• Diagnosis of Slowness: Identify several probable causes of slow performance along with detailed explanations and recommendations. For example:

You:     Why is my Mac slow?
Claude:  I found 3 likely causes, most likely first:

         1. It has been a long time since the last restart (uptime 23 days).
         2. Memory is tight (memory pressure: warning, 4.2 GB swap).
         3. One app is keeping the processor busy (DemoApp at 145 % CPU in both measurements).

• Comprehensive Overview: The get_mac_overview tool evaluates the overall health of your Mac, providing grades and advice based on various metrics such as CPU load, memory pressure, and free disk space.

• Real-time Monitoring: The top_processes tool displays which applications and processes are utilizing the most system resources at any given moment.

• Detailed Reporting: Each built-in tool focuses on specific metrics, providing structured, easy-to-understand results:

  • memory_report: Reports on memory usage including pressure and swap statistics.
  • disk_report: Assesses disk space and provides insights on the largest folders within your home directory.
  • battery_report: Monitors battery health, charge state, and cycles (skips on desktop Macs).

Privacy and Security

• The system runs entirely locally, utilizing built-in macOS commands to gather data without any network requests.
• No data is collected or sent externally; all generated responses remain within the user's device.
• Ensures safety with read-only operations, never altering system settings or data.

Requirements

• Operable exclusively on macOS, with Node.js version 18 or newer for server functionality.
• No additional dependencies are necessary; the installation process is streamlined and efficient.

This tool is designed for users seeking to maintain optimal system performance while understanding the health and functionality of their Macs. Through straightforward communication, Mac Health MCP enhances user ability to troubleshoot and optimize their device's performance.