Hwip
Let a coding agent ask you a question on your phone and wait for the answer
- Platforms
- CLI
- Runs
- Locally
- Version
- 0.1.7
- Listing updated
- 4 days ago
Similar MCP servers
About Hwip
Hwip is an MCP server for developer tools. It runs locally on your machine and is started by your AI client.
The core call is hwip_ask. The agent sends a question, it appears on the Hwip phone app as buttons and a text field, and your reply returns inside the same tool call so the agent carries on, for example after you tap Deploy. On Node 22 or later the answer arrives over a WebSocket immediately; on older Node the server polls and says so on stderr.
The same server handles one-way notifications, clipboard pushes, file transfers and channel broadcasts, and an optional hwip_session_title lets an agent name its own session. It works with Claude Code, Cursor, Windsurf, Gemini CLI and any MCP client. Setup is npm install -g @hwip/cli then hwip install, which writes credentials to ~/.hwip/config.json and configures agents; the server can also be added manually.
The README is strict about credentials: the config file is ignored if another user owns it or it is world-writable, API keys are never sent along a redirect, and a key from the file does not follow a different base URL from the environment. API replies are read up to 8 MiB, and file downloads up to 1 GiB.
Install
Run in a terminal
claude mcp add mcp-server --env HWIP_API_KEY='<HWIP_API_KEY>' -- npx -y @hwip/mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@hwip/mcp-server"
],
"env": {
"HWIP_API_KEY": "<HWIP_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@hwip/mcp-server"
],
"env": {
"HWIP_API_KEY": "<HWIP_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hwip/mcp-server"
],
"env": {
"HWIP_API_KEY": "<HWIP_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@hwip/mcp-server"
],
"env": {
"HWIP_API_KEY": "<HWIP_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@hwip/mcp-server"
],
"env": {
"HWIP_API_KEY": "<HWIP_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
HWIP_API_KEYYour Hwip API key. Optional when ~/.hwip/config.json (from `hwip login`) holds one.
Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- hwip_ask
- Sends a question to the phone and returns the reply into the same tool call.
- hwip_notify
- Sends a one-way notification to devices.
- hwip_clipboard
- Sends clipboard content to a device.
- hwip_file
- Sends a file to a device.
- hwip_session_title
- Lets the agent name its own session, enabled with HWIP_AUTONAME.
What it does
- Questions on your phone
- hwip_ask turns an agent question into buttons and a text field.
- Push notifications
- One-way alerts to chosen or all devices.
- Clipboard and files
- Send clipboard text and files to a device.
- Channel broadcasts
- Notify a channel rather than a single device.
- Credential safeguards
- Config file permissions and redirect refusal protect the API key.
- Self-naming sessions
- hwip_session_title lets the agent label its own session.
Good for
- Get approval on your phone before a deploy
- Be notified when a long agent task finishes
- Send a file or snippet from a session to your phone
- Answer a clarifying question while away from the desk
Pricing
Pricing unknown
Hwip service pricing not published.
Hwip FAQ
What do I need to run it?
Node 18.17 or later; Node 22+ gives instant answers over a WebSocket.
Where are credentials kept?
In ~/.hwip/config.json, or HWIP_API_KEY in the environment.
Which agents work?
Claude Code, Cursor, Windsurf, Gemini CLI and any MCP client.
Does it need npx?
Not necessarily; a global install avoids the slower npx start.
How do I add Hwip to Claude Code?
Run this command in your terminal: claude mcp add mcp-server --env HWIP_API_KEY='<HWIP_API_KEY>' -- npx -y @hwip/mcp-server
What are the best alternatives to Hwip?
The closest alternatives to Hwip are Hawl, A2H: ask a human, hoptell, agent-intercom and HITL (Human in the Loop).
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.