Keyboard Clean
Lock your Mac keyboard to clean it
Wipe crumbs and fingerprints off the keys without typing gibberish into a document or setting off shortcuts.
Keyboard Clean is an Edith extension that blocks every key press on your Mac behind a full-screen overlay so you can wipe the keyboard, then unlocks when you click Done cleaning or after 60 seconds.
Cleaning a MacBook keyboard while the Mac is on is surprisingly messy. Every pass of the cloth presses keys, which can type into a chat, fire shortcuts, change the volume or open apps. Shutting down avoids that, but it means closing everything and waiting through a restart just to remove a few smudges. Keyboard Clean switches the keys off for a minute instead.
Start it from the Clean keys toggle on Home, in the notch or in the sidebar, or with ed keyboard clean. A three second countdown gives you time to lift your hands, then an overlay covers every display and Edith swallows key presses, modifier keys and media keys included, until you are done. The trackpad and mouse keep working, so you click Done cleaning when the keys are spotless.
A safety timer unlocks the keyboard by itself after 60 seconds, so the overlay can never leave you stuck without a keyboard. Blocking keystrokes needs two macOS permissions, Input Monitoring and Accessibility. Edith asks for them the first time you start a clean, and its settings show whether both are granted.
Updated
How to disable the keyboard while cleaning a Mac
- 1
Clean keys
Choose Clean keys on Home, in the notch or in the sidebar. Lift your hands during the 3 second countdown.
- 2
Wipe while the keys are locked
Key presses do nothing while the overlay is up, on every display.
- 3
Allow two permissions once
Input Monitoring and Accessibility let Edith block key presses. Settings shows both.
What it does
Lock the keyboard to clean it
Wipe your keys while every key press is ignored.
Does macOS do this already?
Can you disable a Mac keyboard for cleaning without an app?
Not directly. macOS has no keyboard lock for cleaning, and locking the screen does not help because the first key press wakes it and starts typing into the password field. Apple's cleaning guidance suggests turning the Mac off first. Keyboard Clean gives you a minute with every key ignored while your apps and windows stay exactly where they were.
Use cases
A quick wipe between meetings
Press Clean keys, run a microfiber cloth across the keyboard while the overlay is up, and get back to work without restarting or closing a single window.
Clean an external keyboard at the same time
The lock applies to key presses system-wide, so a Magic Keyboard or any other keyboard connected to the Mac is silenced together with the built-in one.
Wipe down a shared Mac
On a Mac at a front desk or in a classroom, clean the keys with a lightly damp lint-free cloth while the overlay is up, without logging anyone out, typing into a form or quitting an app by accident.
From the terminal and your coding agents
Every example returns JSON with --json, and agents can call the same thing over MCP.
$ ed keyboard clean
$ ed keyboard status
$ ed keyboard stop| Command | MCP tools |
|---|---|
ed keyboard | edith_keyboard_* |
Connect Claude Code, Codex, Cursor or another client through the Edith MCP server.
Permissions and requirements
Permissions
- Input Monitoring, so Edith can see key presses in order to block them
- Accessibility, so Edith can stop those key presses reaching other apps
Requirements
- macOS 14 or later on Apple silicon
Frequently asked questions
How do I unlock the keyboard again?
Click Done cleaning on the overlay with your trackpad or mouse. If you do nothing, the keys unlock by themselves after 60 seconds.
Does it lock the trackpad or mouse too?
No. Only key presses are blocked, so the pointer stays free for the Done cleaning button. Wipe the trackpad once the keys are unlocked.
Why does it need Input Monitoring and Accessibility?
macOS only lets an app intercept keystrokes with Input Monitoring, and keeping them from reaching other apps needs Accessibility. Without both, Clean keys asks you to grant them instead of starting.
Does the overlay appear on every display?
Yes. Each connected display shows the overlay while the keys are locked, so a second monitor does not reveal anything you could accidentally type into.
Can an agent start or stop keyboard cleaning?
Yes. Edith's MCP server has edith_keyboard_clean, edith_keyboard_status and edith_keyboard_stop, which match ed keyboard clean, status and stop. The same countdown and 60 second limit apply.
Does Keyboard Clean come with the one-time Edith purchase?
Yes. There is no separate charge for it; it is one of the small utilities included with Edith.
More in Mac Utilities
Get Edith.
From $35 once. No subscription. No account.
Needs a license key · macOS 14 or later on Apple silicon · 6.4 MB