Mac battery health checker
Updated 6 November 2026 · Who measures this.
One Terminal command prints your battery's capacity in milliamp hours (mAh). Your Mac stores 2 capacity numbers, and macOS shows 1 whole percent that can match either of them or neither. The command prints both numbers next to the design capacity and the cycle count, with no download and no password.
What command shows your Mac's battery health?
An ioreg command pasted into Terminal. It reads the battery's entry in the macOS registry, changes nothing and
prints 4 lines: the design capacity, 2 capacities for today and the cycle count.
{ ioreg -rn AppleSmartBattery -a; ioreg -rn AppleSmartBatteryPack -a; } 2>/dev/null | awk -F'[<>]' '/<key>/{k=$3} /<integer>/{v[k]=$3} END{d=v["DesignCapacity"]+0; r=v["AppleRawMaxCapacity"]+0; c=v["NominalChargeCapacity"]+0; if(d==0||r==0){print "No battery found on this Mac"; exit} printf "Design capacity: %d mAh\nRaw today: %d mAh, %.1f%%\nReported today: %d mAh, %.1f%%\nCycle count: %d\n", d, r, r/d*100, c, c/d*100, v["CycleCount"]}'
A 14-inch MacBook Pro with M3 Max on macOS 27.0 printed this:
Design capacity: 6249 mAh Raw today: 5166 mAh, 82.7% Reported today: 5318 mAh, 85.1% Cycle count: 653
| Line | What it means |
|---|---|
| Design capacity | What the battery was built to hold |
| Raw today | What the battery's gauge estimates it holds now, and that as a share of the design capacity |
| Reported today | The smoothed figure the battery's controller publishes beside it, and that as a share of the design capacity |
| Cycle count | How many charge cycles the battery has counted |
Which number does macOS show?
It depends on the Mac. We ran the command on 4 Macs and read Maximum Capacity in System Information in the same minute: 2 matched the reported number as a whole percent, 1 the raw number and 1 neither.
| Mac | macOS | Raw today | Reported today | System Information |
|---|---|---|---|---|
| 14-inch MacBook Pro, M1 Pro | 14.2.1 | 78.8% | 81.3% | 81% |
| 13-inch MacBook Pro, M1 | 26.7.1 | 83.0% | 85.7% | 83% |
| 14-inch MacBook Pro, M3 Max | 27.0 | 82.7% | 85.1% | 85% |
| 13-inch MacBook Air, M2 | 27.2 | 87.0% | 89.8% | 88% |
The MacBook Air's 88% matches neither of its numbers. The M3 Max did the same in an earlier reading: 81.9% raw, 84.3% reported and 86% in System Information. We have not found how macOS picks its figure, so compare macOS's figure only with macOS's figure.
How should you read the 2 numbers?
As 2 different quantities, not 2 attempts at one measurement. The raw one is what the gauge currently estimates the pack holds, and the reported one is the smoothed figure the controller publishes beside it. On the M3 Max they sat 152 mAh apart on some days and 308 mAh apart on another, so the gap is not a constant you can subtract. Why your Mac reports 2 health numbers takes that apart.
Read the whole number, not the decimals. Over a single session the raw capacity of that Mac moved from 5270 to 5301 mAh, half a percentage point, as the charge and the temperature changed.
Is your number normal for its mileage?
Compare it with what other Macs report. We collected 1,539 pairs of cycle count and health percentage that people posted about their own Macs. Of the 441 reports with fewer than 50 cycles, the median was 99% and 225 of them were already below 100. The lowest was 77%. macOS never shows more than 100, so from new the number can only go down, and it starts immediately.
Use the number System Settings shows you, not the raw one. The reports were read from System Settings, and mixing scales would put a healthy Mac below the average by arithmetic alone. Health against cycle count has the table by mileage.
What does MaxCapacity mean on Apple silicon?
It is the top of the percentage scale, not your battery's capacity: the charge percentage is counted out of it. It read 100 on all
4 Macs above. Guides that tell you to divide MaxCapacity by DesignCapacity were written for Intel Macs,
where that key really did hold milliamp hours. They are wrong on every Apple silicon Mac.
Why does the popular ioreg command return garbage?
Because the same key names appear twice. Search for this and you will be told to run
ioreg -l | grep -i "MaxCapacity\|DesignCapacity". Inside the battery's BatteryData block the keys appear
again, so grep drags out a line of raw gauge data about 2 kilobytes long and the useful lines drown in it.
The command above uses -a, which returns the registry as a property list with 1 key per line. On macOS 27 the raw
capacity moved to a child entry, AppleSmartBatteryPack, so the command reads both places.
Questions people ask
Should I reset the SMC to fix a wrong battery percentage?
No. On Apple silicon the SMC resets itself when you restart or shut down with the Mac plugged in, and Apple lists no key combination for it (support.apple.com/en-us/102605). The number is a measurement rather than a setting, so there is nothing in it to repair.
Does calibrating the battery help?
Deep discharge calibration applied to batteries Apple stopped shipping years ago. On a modern pack, draining to zero costs you a cycle and does not make the battery healthier. It can move the capacity estimate afterwards, in either direction, as the gauge re-learns.
Why does coconutBattery show a lower number than System Settings?
Most likely it reads the raw capacity, which sat 2.4 to 4.9 points below the reported one on the Mac we measured on macOS 26. We have not checked which key coconutBattery reads. Both key readings are real, so the forum answer that "one of them is buggy" is wrong.
The command printed "No battery found on this Mac"
An iMac, Mac mini or Mac Studio has no battery to read. On a MacBook, first check that you copied the whole command. If it still prints this, the pack is not being detected at all, and that is worth a service appointment.
How it was measured
| The command | Run in zsh and bash on macOS 14.2.1, 26.7.1, 27.0 and 27.2. |
| Earlier readings | The same 14-inch MacBook Pro with M3 Max: 87.3% reported against 87% in System Settings on macOS 26.5.2, and the earlier macOS 27.0 reading. |
| Reports from people | 1,539 public posts, read from System Settings by their authors. Where they come from and where they stop applying. |
What this doesn't show
- How macOS picks its figure. We have not found it, and Apple does not publish the rule.
- How long a charge will last. Capacity says what the battery holds, not what your apps spend: 96% health and 4 hours of life.
- Intel Macs. We ran the command on Apple silicon only.
Related: why there are 2 numbers · health against cycle count · checking a used MacBook · the other tools
Keep the health number, and see what spends the charge
10 days free, no card · Requires macOS 14 or later · Apple silicon