Manual setup required. We don't have a verified install command for this server. Follow the maintainer README and use the raw config below as a starting point.
1
Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/paulbennet/afk-mode-mcp
cd afk-mode-mcpThen follow the repository README for any remaining dependency or build steps.
2
Add it to Claude Code
Paste the maintainer's config below, then edit any placeholder values.
{
"servers": {
"afk-mode-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"afk-mode-mcp"
],
"env": {
"AFK_PORT": "7842"
}
}
}
}See the afk-mode-mcp README for full setup instructions.
Environment Variables
Set these before running AFK Mode.
VariableDescriptionRequired
AFK_PORTThe port number for the web server (default 7842)NoAvailable Tools (4)
Once configured, AFK Mode gives your AI agent access to:
get_current_web_app_urlReturns the connection URL and QR code for pairing your phone.get_afk_statusChecks if AFK mode is on and a client is connected.notify_session_progressSends a progress update to the phone including info, warning, error, success, or milestone status.get_user_decisionAsks the user a question and blocks until they respond with a confirm, choice, text, or diff review.Try It Out
After setup, try these prompts with your AI agent:
→Show me the AFK app link so I can pair my phone.
→Check if AFK mode is currently active and connected.
→Notify my phone that the current task has reached a milestone.
→Ask me for a decision on this code diff using AFK mode.
Prerequisites & system requirements
- An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
- Node.js 18+ with npm/npx installed
Keep this setup from going cold
Save the docs, env vars, and workflow around AFK Mode in Conare so Claude Code, Codex, and Cursor remember it next time.