Mac Health MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
When the user asks why their Mac is slow, start with diagnose_slowness (ranked likely causes with the numbers behind them). Use get_mac_overview for a graded health check of this Mac (uptime, CPU, memory, disk, battery, heat). Dig deeper with top_processes (what is using CPU/memory), memory_report (pressure, swap, compression) disk_report (free space, largest home folders), battery_report, thermal_status and startup_items (what starts automatically). All tools are read-only and local.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| diagnose_slownessA | Finds the likely reasons why this Mac feels slow and ranks them, most likely first. Checks uptime (over 14 days), memory pressure and swap (over 2 GB, naming the apps using most memory), free disk (under 10 %, naming the largest home folders), single processes over 80 % CPU in two measurements (named and explained), Spotlight indexing, heat throttling (kernel_task) battery health (under 80 %) and startup items (15 or more from third parties, at most three names shown). Each cause has a plain-Swedish explanation, the number behind it and what the user can do. Use it first when the user asks why their Mac is slow. Takes a few seconds (longer only if the disk is nearly full). Read-only, local. |
| get_mac_overviewA | Health check of this Mac: model, macOS version, uptime, CPU load, memory pressure (incl. swap), free disk space on the startup disk, battery (charge, health, cycles) and thermal throttling. Each part gets a grade: "Bra" (good), "Okej" (ok) or "Behöver åtgärd" (needs attention), plus advice. Use it when the user asks how their Mac is doing or why it is slow. Read-only, local, no admin password. |
| top_processesA | The apps and processes using the most CPU and memory right now (measured over about a second), with plain-language explanations of cryptic macOS names (e.g. mds_stores = Spotlight indexing, kernel_task, WindowServer, bird/cloudd = iCloud, backupd = Time Machine). Helpers are also grouped per app. Only process names are returned, never user names or full paths. Use it when the Mac is slow, hot or the fan is loud. Read-only. |
| memory_reportA | Memory pressure, swap, compressed memory and file cache, explained in plain Swedish with a grade ("Bra", "Okej", "Behöver åtgärd"). Use it when the user wonders if their Mac has enough RAM or why it is sluggish. Read-only. |
| disk_reportA | Free space on the startup disk with a grade and warning when it gets low, plus the largest folders in the home folder (shown as ~/Library, ~/Downloads …). Only reads sizes, never deletes anything. Measuring the home folder can take up to about 20 seconds; if it takes longer the tool answers with what it has. Folders protected by macOS are skipped and reported. |
| battery_reportA | Battery health (capacity compared to new), charge cycles, charge state, temperature and tips, with a grade. Desktop Macs without a battery get a calm "no battery" answer. Serial numbers are never returned. Read-only. |
| thermal_statusA | Whether macOS is slowing the processor down because the Mac is too hot (thermal throttling), with a grade and advice. Use it when the Mac is hot, the fan is loud or it suddenly feels slow. Read-only. |
| startup_itemsA | What starts automatically: launch agents and daemons in ~/Library/LaunchAgents, /Library/LaunchAgents and /Library/LaunchDaemons, each marked as Apple or third party. Only lists folder contents; never changes or deletes anything. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Several tools overlap: diagnose_slowness and get_mac_overview both answer 'why is my Mac slow' and include uptime, memory, disk, battery and thermal checks, creating real misselection risk. The component reports (memory_report, disk_report, battery_report, thermal_status, top_processes, startup_items) are more clearly scoped, but they also duplicate data exposed by the aggregate tools.
All names use snake_case, which is good, but the patterns are mixed: diagnose_slowness and get_mac_overview are verb_noun, while memory_report, disk_report, battery_report, thermal_status and startup_items are noun_noun, and top_processes has no clear verb convention. The set remains readable, but it does not follow one predictable naming scheme.
Eight tools is a well-scoped size for a Mac health diagnostics server. Each tool has a recognizable role: one ranked diagnosis, one overview, and six focused component inspections.
The surface covers the main health areas: slowness diagnosis, CPU/memory, disk, battery, thermal throttling, startup items and an overview. Minor gaps remain around network diagnostics, SMART/storage health, crash logs or macOS update status, but most common Mac health questions are supported.