
This MCP server lets an AI agent use Keep Mac Awake, a macOS app that keeps a MacBook with Apple
This MCP server lets an AI agent use Keep Mac Awake, a macOS app that keeps a MacBook with Apple silicon awake with the lid closed during a session. It needs the app, which is installed separately and is a paid app with a free trial (keepmacawake.com). With it, the agent starts a timed session before long work, stops it when the work is done, and tells you when the app needs something from you, such as AC power or a purchase after the trial. Why an agent needs it: a MacBook sleeps when you close the lid, and the agent's work stops with it (keep AI agents running with the lid closed).
·
This MCP server lets an AI agent use Keep Mac Awake, a macOS app that keeps a MacBook with Apple silicon awake with the lid closed during a session. It needs the app, which is installed separately and is a paid app with a free trial (keepmacawake.com). With it, the agent starts a timed session before long work, stops it when the work is done, and tells you when the app needs something from you, such as AC power or a purchase after the trial. Why an agent needs it: a MacBook sleeps when you close the lid, and the agent's work stops with it (keep AI agents running with the lid closed).
It works in any app that runs local MCP servers (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf and others). If your agent takes plugins, the Keep Mac Awake plugin does the same with a skill and adds a session-start hook.
| Tool | What it does |
|---|---|
keep_awake_status | Whether a session runs and its time left, the free trial, and a newer version of the app. Read only. |
keep_awake_start | Starts a session of 1 to 168 whole hours, or without a time limit. |
keep_awake_stop | Ends the session and restores the normal sleep setting. |
The agent starts timed sessions on its own and tells you in one line. It asks you first before a session without a time limit, before the first session on a Mac, which starts the free trial, and before a session that may run on battery when Run on battery turned itself on (on a MacBook on battery, at 20%, unless you set it yourself): keep_awake_start refuses each of these until the agent passes user_agreed, or battery_agreed for battery use; one never stands in for the other. When you set Run on battery yourself, or with Keep Mac Awake 1.0.10 or earlier, a session the agent starts may run on battery down to your level without a question, and the agent says so. It never starts a second session over a running one. The battery settings, Mute sound when lid closes (keepmacawake config set --mute-on-lid-close on, which keeps notifications quiet while the lid is closed), buying and installing stay with you, in the menu bar panel or in Terminal.
You need Node.js 20 or later and the Keep Mac Awake app (any Mac with Apple silicon and macOS 26 or later).
Claude Code:
claude mcp add keepmacawake -- npx -y keepmacawake-mcpCodex:
codex mcp add keepmacawake -- npx -y keepmacawake-mcpClaude Desktop, Cursor and other apps with a JSON configuration (claude_desktop_config.json, .cursor/mcp.json):
{
"mcpServers": {
"keepmacawake": {
"command": "npx",
"args": ["-y", "keepmacawake-mcp"]
}
}
}The server is the npm package keepmacawake-mcp and is listed in the official MCP Registry as com.keepmacawake/mcp.
If the app reports that npx is not found, give its full path, for example /opt/homebrew/bin/npx.
From a clone of this repository instead of npm:
git clone https://github.com/bartdudzic/keepmacawake
cd keepmacawake/mcp && npm ci --omit=dev
claude mcp add keepmacawake -- node "$PWD/bin/keepmacawake-mcp.mjs"keepmacawake command once on this Mac (status, start or stop, with --json), from /usr/local/bin, where the installer puts it, or from PATH. Set KEEPMACAWAKE_CLI to use another path.sudo, no settings changes, no payments.The server sends nothing anywhere. Its results become part of the agent's conversation, so the agent's provider receives them: whether a session runs, its time left, the trial's time left, the battery settings and a newer version. From the app's reply the server passes on only those fields: never this Mac's ID, the purchase details or the app's own messages, apart from the short reason the app gives when it refuses a session. The app's own data use is in its privacy description.
KEEPMACAWAKE_CLI if the command is somewhere else.keepmacawake config set --battery allowed.npm ci
npm testThe tests run against a fake keepmacawake command and never touch a real session.
Write to [email protected]. Security issues: see SECURITY.md. Keep Mac Awake is not affiliated with Apple.
The server is under the MIT License. The Keep Mac Awake app it controls is not: buying it after the free trial is covered by its own terms.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add keepmacawake -- npx -y keepmacawake-mcp{
"mcpServers": {
"keepmacawake": {
"args": [
"-y",
"keepmacawake-mcp"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"keepmacawake","args":["-y","keepmacawake-mcp"],"command":"npx"}'[mcp_servers.keepmacawake]
command = "npx"
args = ["-y", "keepmacawake-mcp"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/keep-mac-awake-mcp-server to learn what the "Keep Mac Awake MCP server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add keepmacawake -- npx -y keepmacawake-mcp
claude mcp add keepmacawake -- node "$PWD/bin/keepmacawake-mcp.mjs"| Name | What it does |
|---|---|
keep_awake_status | Shows whether Keep Mac Awake is keeping this Mac awake: whether a session runs and its time left, the free trial, and a newer version. Read only. Call it before starting a session. |
keep_awake_start | Keeps this MacBook awake with the lid closed, for a number of whole hours or without a time limit, through the Keep Mac Awake app. Use it before a long task the user asked for, with hours a little lon |
keep_awake_stop | Ends the running Keep Mac Awake session and restores the normal sleep setting. Use it when a task you started the session for is done. Do not stop a session the user started themselves, or one they as |
Read live from the server on November 6, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/keep-mac-awake-mcp-server)Nothing comparable is listed yet.
v1.0.11Keep Mac Awake 1.0.11Release notesv1.0.10Keep Mac Awake 1.0.10Release notesv1.0.9Keep Mac Awake 1.0.9Release notesv1.0.8Keep Mac Awake 1.0.8Release notesv1.0.7Keep Mac Awake 1.0.7Release notesv1.0.6Keep Mac Awake 1.0.6Release notesv1.0.5Keep Mac Awake 1.0.5Release notesv1.0.4Keep Mac Awake 1.0.4Release notesv1.0.3Keep Mac Awake 1.0.3Release notesv1.0.2Keep Mac Awake 1.0.2Release notesv1.0.1Keep Mac Awake 1.0.1Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "keep-mac-awake-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.