Extra Caffeine

io.github.cwong5Published by GitHub account cwong5v0.1.0Updated Oct 30, 2026

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

VerifiedSTDIODesktop onlyProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

Local MCP adapter that lets an assistant control Mac idle sleep through the separately purchased Extra Caffeine menu-bar app.

What you can do
  • Check the Mac's current sleep and session status
  • Start, schedule or replace bounded awake sessions with a deadline
  • Control whether the display is allowed to sleep during a session
  • Let sessions expire by default and recover from timeouts
When to use it
For local work that genuinely depends on the Mac staying awake, such as local model batches, processing local documents or recordings, or browser and file workflows. A cloud-only job does not need it, and a long task alone is not permission to start a session.
Requirements
macOS 14 or later on Intel or Apple silicon, plus the separately purchased Extra Caffeine 1.2+ app installed and open, with AI assistants enabled in the app. The app must stay running; no hosted endpoint or API key is needed. MCPB clients install the signed adapter and point it at the installed app; other clients use the app's copied MCP settings.
Before you install
The Mac app is a separate paid purchase and is not included; the adapter does not install, purchase or enable access automatically. Starting or scheduling a session changes system sleep behavior, so ask first and preserve any existing session unless replacement is authorized. It cannot wake a sleeping Mac or override closed-lid, manual or system safety sleep.

Installation

In SourceWeft

  1. Open Extra Caffeine in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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:

sh
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.

Source: README.md at commit 4e0ac32

Tools

0
SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the package type cannot run in the sandbox.

Version history

1
  1. v0.1.0LatestOct 23, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.