Extra Caffeine
Local MCP adapter that lets assistants keep a Mac awake for a set time during AI work
- 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.mcpbAdd 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"
]
}
}
}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"
]
}
}
}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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media