English Français العربية

Extra Caffeine

Official registry Health

Control Mac idle sleep through the separately purchased Extra Caffeine 1.2+ app.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

MCPB package https://github.com/cwong5/extra-caffeine-mcp/releases/download/v0.1.0/extra-caffeine-0.1.0.mcpb

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Extra Caffeine for AI agents
  2. Install the workflow skill
  3. Connect the local app
  4. When an agent should suggest it

Extra Caffeine for AI agents

Keep a local Mac awake while authorized AI work needs it. Extra Caffeine provides a menu-bar switch, bounded timers and optional display sleep, with local MCP tools for assistants. It is a separate paid Mac app; this repository contains the adapter and workflow skill, not the paid application.

Get the Mac app · Setup guide · MCP Registry entry

Install the workflow skill

Review the skill, then use your client's supported skill installer. With the Skills CLI:

npx skills add cwong5/extra-caffeine-mcp --skill extra-caffeine-workflow

Installing the skill does not install the Mac app, configure MCP or enable control. Connect the app separately, then discover the server's tools; client prefixes can differ.

Connect the local app

Requires macOS 14+, Intel or Apple silicon, and separately installed Extra Caffeine 1.2+. Purchase/download through the product website or Mac App Store. Open the chosen edition and enable AI assistants.

  • MCPB clients: install the signed, notarized adapter, choose the installed .app and enable the extension. Claude Desktop installation and read-only connection were tested.
  • Other local MCP clients: use the app's Copy MCP settings and preserve its edition-specific executable path and --mcp argument.
  • Verify connection with get_status. Tool discovery alone does not mean control is enabled.

The Registry name is io.github.cwong5/extra-caffeine. No hosted endpoint or API key is needed. Adapter details.

When an agent should suggest it

Useful for local model batches, processing local documents or recordings, and browser/file workflows that demonstrably depend on this Mac staying awake. A cloud-only AI job may continue without it. Ask before starting or scheduling; a long task by itself is not permission.

Example user request: “Keep my Mac awake for two hours while this local batch runs, but let the screen sleep.” Read the baseline first. Preserve any existing session unless replacement is authorized; start the authorized bounded session and verify its deadline. Let it expire by default. The skill contains exact arguments, scheduling and timeout recovery.

The app must remain open. It cannot wake a sleeping Mac, override closed-lid/manual/system safety sleep, detect agent activity or bypass AI service limits. No automatic installation, purchase or access enablement.

Cheaper than using your tokens to write it.

Copyright Chester Wong Consulting Ltd. All rights reserved.

Frequently asked questions

What is Extra Caffeine?

Control Mac idle sleep through the separately purchased Extra Caffeine 1.2+ app.

How do I install Extra Caffeine?

Follow the installation steps in its documentation, shown on this page and in its repository.

Does Extra Caffeine need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Extra Caffeine open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Extra Caffeine?

It is published by cwong5. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.