MCP server · App Intents · CLI
Every feature can be called by an AI assistant. Everything runs locally on the Mac — the AI sends a request, StayLit does the work, nothing is uploaded by StayLit.
Open StayLit → Settings → AI → Connect. Restart the AI app.
Settings → AI → Copy Command, then paste into Terminal.
Actions appear in the Shortcuts app under StayLit.
Manual MCP config:
{
"mcpServers": {
"staylit": {
"command": "/Applications/StayLit.app/Contents/MacOS/staylit",
"args": ["mcp"]
}
}
}
| Tool | What it does | Changes files? |
|---|---|---|
keep_awake | Prevent this Mac from idle-sleeping until a condition is met (whichever comes first): duration, a clock time, an app quitting, a process exiting, or downloads in ~/Downloads finishing. With no condition it stays awake until stop_keep_awake. Optionally sleep or shut down afterwards (1-minute cancellable warning). Replaces any current keep-awake session. | Yes |
stop_keep_awake | Stop the current StayLit keep-awake session; the Mac sleeps normally again. Does not sleep the Mac and does not cancel a scheduled sleep/shutdown. | Yes |
awake_status | What is keeping this Mac awake right now: StayLit's session (and time left), any scheduled sleep/shutdown, and every other app or process preventing sleep (e.g. Zoom, caffeinate). Read-only. | No |
schedule_power | Put the Mac to sleep or shut it down at a time, independent of keep-awake. The user gets a 1-minute warning and can cancel. Apps are asked to save documents on shutdown. Only one schedule at a time (replaces the previous one). | Yes |
cancel_schedule | Cancel a scheduled sleep or shutdown, including the 1-minute countdown after a keep-awake session ends. | Yes |
staylit list staylit keep_awake --duration 3h --then sleep