# Hwip

> Hwip is an MCP server for developer tools. Let a coding agent ask you a question on your phone and wait for the answer. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI
- **Repository:** https://github.com/hwipit/mcp-server
- **MCP Registry name:** io.github.hwipit/mcp-server
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-15

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server --env HWIP_API_KEY='<HWIP_API_KEY>' -- npx -y @hwip/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@hwip/mcp-server"
      ],
      "env": {
        "HWIP_API_KEY": "<HWIP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@hwip/mcp-server"
      ],
      "env": {
        "HWIP_API_KEY": "<HWIP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@hwip/mcp-server"
      ],
      "env": {
        "HWIP_API_KEY": "<HWIP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@hwip/mcp-server"
      ],
      "env": {
        "HWIP_API_KEY": "<HWIP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@hwip/mcp-server"
      ],
      "env": {
        "HWIP_API_KEY": "<HWIP_API_KEY>"
      }
    }
  }
}
```

## Tools

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

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

## Alternatives

- [Hawl](https://ai-powered.com/mcp/hawl): Hawl is a free MCP server for developer tools.
- [A2H: ask a human](https://ai-powered.com/mcp/a2h-ask-a-human): A2H: ask a human is a free MCP server for communication.
- [hoptell](https://ai-powered.com/mcp/hoptell): hoptell is an open-source MCP server for developer tools.
- [agent-intercom](https://ai-powered.com/mcp/agent-intercom): agent-intercom is a free MCP server for developer tools.
- [HITL (Human in the Loop)](https://ai-powered.com/mcp/hitl-human-in-the-loop): HITL (Human in the Loop) is a freemium MCP server for developer tools.
- [message-cp](https://ai-powered.com/mcp/message-cp): message-cp is an open-source MCP server for communication.
- [Invoke Human Tool](https://ai-powered.com/mcp/invoke-human-tool): Invoke Human Tool is a free MCP server for productivity.
- [Homing Pigeon](https://ai-powered.com/mcp/homing-pigeon): Homing Pigeon is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/hwip
