Skip to content
MCP server

Extra Caffeine

Local MCP adapter that lets assistants keep a Mac awake for a set time during AI work

Runs locallyStatus and history
Install
Pricing
Free
Platforms
macOS
Runs
Locally
Version
0.1.1
Listing updated
3 days ago

About Extra Caffeine

Extra Caffeine is a free MCP server for productivity. It runs locally on your machine and is started by your AI client.

Long local jobs, such as batches of documents, recordings or a local model run, can stall when a laptop idles into sleep. This adapter connects an assistant to the free Extra Caffeine Mac app so it can check the awake status and start or manage timed sessions, optionally letting the display sleep.

The app must be installed separately (macOS 14 or later, Intel or Apple silicon, app version 1.2+) and assistant access is off until you enable it in the app. The README stresses limits: the app has to stay open with the lid up, it only prevents idle sleep, and it cannot wake a sleeping Mac, override manual or safety sleep, or extend AI service limits. Cloud-only jobs may not need it.

A companion workflow skill tells agents to read the current state first, preserve any existing session unless replacing it is authorised, ask before starting one, and let it expire by default. It installs as a signed, notarized MCPB extension, which the README says was tested in Claude Desktop, or through the app's copy-settings option for other local clients. There is no hosted endpoint or API key.

Install

Run in a terminal

claude mcp add extra-caffeine -- npx -y https://github.com/cwong5/extra-caffeine-mcp/releases/download/v0.1.0/extra-caffeine-0.1.0.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "extra-caffeine": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/cwong5/extra-caffeine-mcp/releases/download/v0.1.0/extra-caffeine-0.1.0.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "extra-caffeine": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/cwong5/extra-caffeine-mcp/releases/download/v0.1.0/extra-caffeine-0.1.0.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "extra-caffeine": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/cwong5/extra-caffeine-mcp/releases/download/v0.1.0/extra-caffeine-0.1.0.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "extra-caffeine": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/cwong5/extra-caffeine-mcp/releases/download/v0.1.0/extra-caffeine-0.1.0.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "extra-caffeine": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/cwong5/extra-caffeine-mcp/releases/download/v0.1.0/extra-caffeine-0.1.0.mcpb"
      ]
    }
  }
}

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

get_status
Checks the connection and the current awake status.

What it does

Timed awake sessions
Starts bounded sessions so the Mac stays awake while a task runs.
Status check
A get_status call confirms the connection and shows the current session.
Optional display sleep
Lets the screen sleep while the Mac stays awake.
Opt-in control
Assistant access stays off until enabled in the app.
Workflow skill
A skill tells agents to ask first, keep existing sessions and let sessions expire.
MCPB install
Ships as a signed, notarized extension for MCPB clients.

Good for

  • Keep a Mac awake for two hours during a local batch run
  • Process local documents or recordings without the laptop sleeping
  • Let an agent check whether a session is already running before starting one
  • Run browser or file workflows that depend on the Mac staying on

Pricing

Free

Free app and adapter; no subscription

Prices change. Check extracaffeine.chesterwong.com before you buy.

Extra Caffeine FAQ

Does it cost anything?

The README says the Mac app and the adapter are free, with no payment, subscription or expiry.

What does it need?

macOS 14 or later and Extra Caffeine 1.2+ installed separately; the app must stay open with the lid open.

Can it wake a sleeping Mac?

No. It prevents idle sleep only and cannot wake a sleeping Mac or bypass AI service limits.

Does it need an API key?

No. There is no hosted endpoint or API key; the server runs locally.

Is Extra Caffeine free?

Yes. Extra Caffeine is free to use.

How do I add Extra Caffeine to Claude Code?

Run this command in your terminal: claude mcp add extra-caffeine -- npx -y https://github.com/cwong5/extra-caffeine-mcp/releases/download/v0.1.0/extra-caffeine-0.1.0.mcpb

What are the best alternatives to Extra Caffeine?

The closest alternatives to Extra Caffeine are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

Alternatives to Extra Caffeine

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media