# Extra Caffeine

> Extra Caffeine is a free MCP server for productivity. Local MCP adapter that lets assistants keep a Mac awake for a set time during AI work. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** macOS
- **Website:** https://extracaffeine.chesterwong.com
- **Repository:** https://github.com/cwong5/extra-caffeine-mcp
- **MCP Registry name:** io.github.cwong5/extra-caffeine
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## Tools

- `get_status`: Checks the connection and the current awake status.

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/extra-caffeine
