MCP Mac Monitor
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MAC_MONITOR_DRY_RUN | No | Set to 1 to log power commands to ~/.mac-monitor/dry-run.log instead of running them | |
| MAC_MONITOR_STATE_DIR | No | Where scheduled-action state is stored | ~/.mac-monitor |
| MAC_MONITOR_FALLBACK_SECONDS | No | How long a blocked shutdown waits before sleeping the Mac | 120 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_snapshotA | Resumen completo de la Mac en una sola llamada: sistema, batería, memoria, CPU, disco y los 5 procesos que más CPU usan. Úsalo para preguntas generales como '¿cómo está la compu?'. |
| get_batteryA | Batería: porcentaje, si está cargando, fuente de energía, tiempo restante, ciclos, salud (capacidad máxima vs. de fábrica), condición y temperatura. |
| get_memoryA | Memoria RAM: total, usada, memoria de apps, wired, comprimida, caché, swap y presión de memoria (normal/warning/critical). |
| get_cpuA | CPU: chip, núcleos, uso actual (%), carga promedio 1/5/15 min y estado térmico. |
| get_diskA | Espacio en disco: total, usado y libre del disco interno y de los discos externos montados. |
| get_top_processesA | Procesos que más CPU o memoria consumen en este momento. |
| get_energyA | Qué programas consumen más batería ahora mismo. energy_impact es el puntaje POWER de |
| get_system_infoA | Nombre de la Mac, modelo, chip, versión de macOS, usuario, tiempo encendida, modo de bajo consumo, IP local y hora actual. |
| shutdownA | Apaga la Mac de forma normal (como Menú Apple → Apagar), ahora o dentro de X minutos. Siempre espera al menos 60 s. Se puede cancelar con cancel_power_action mientras no se haya ejecutado. Si el apagado queda bloqueado (documento sin guardar, una app que no se cierra), la Mac entra en reposo después de 2 minutos para no gastar batería (fallback_to_sleep). Confirma con el usuario antes de usarlo si no lo pidió explícitamente. |
| restartA | Reinicia la Mac de forma normal, ahora o dentro de X minutos (mínimo 60 s). Cancelable con cancel_power_action. |
| sleepA | Pone la Mac en reposo (sleep), ahora o dentro de X minutos (mínimo 60 s). Casi no gasta batería y no cierra las apps. Ojo: al dormir, Claude en esta Mac deja de responder hasta que alguien la despierte. Cancelable con cancel_power_action. |
| lock_screenA | Apaga la pantalla de inmediato. macOS la bloquea si está configurado para pedir contraseña al apagar la pantalla (por defecto sí). La Mac sigue encendida. |
| get_power_actionA | Indica si hay un apagado/reinicio/reposo programado y cuánto falta. |
| cancel_power_actionA | Cancela el apagado, reinicio o reposo programado, si todavía no se ejecutó. |
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 14 tools
Most tools target a distinct metric or action, but get_snapshot overlaps with the individual get_* monitoring calls, and get_top_processes/get_energy both report process-level usage. The descriptions clarify their intended use, so ambiguity remains limited.
Read operations consistently follow the get_<noun> pattern, while power actions use simple imperative verbs like shutdown, restart, sleep, and lock_screen. Everything uses lowercase snake_case, making the set highly predictable.
With 14 tools, the server is well-scoped: approximately nine monitoring read tools, four power/lock controls, and one pair for checking/canceling scheduled actions. Each tool earns its place without redundancy.
The tool surface fully covers the stated domain: battery, memory, CPU, disk, system info, processes, energy usage, and a complete power-control lifecycle including scheduling and cancellation. No obvious dead ends or missing core operations.