# handup

> handup is a paid MCP server for developer tools. Approval inbox where AI agents ask a human before risky actions like migrations or emails. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** Linux, macOS, Windows, Android, CLI, API, self-hosted
- **Website:** https://gethandup.dev
- **Repository:** https://github.com/gethandup/handup
- **MCP Registry name:** dev.gethandup/handup
- **Categories:** developer tools
- **Listing updated:** 2026-11-18

## About

handup sits between an AI agent and the actions it wants to take. When an agent reaches a step such as a database migration, a release or an outgoing email, it submits a request instead of acting directly. You review a snapshot of the exact diff, command, file or message and approve or deny it from a terminal inbox, the desktop app or an Android phone.

A denial can carry a note, which is returned to the agent so it can revise its plan and ask again. Approvals are tied to the exact content previewed, and the decision is recorded in history, but handup does not execute the action itself. The README says handup works with any MCP client and also offers a CLI and local HTTP API for scripts and CI jobs.

The product is in beta and aimed at developers and individuals who run coding or automation agents on their own computers. Phone access uses either a Tailscale network or a self-hosted end-to-end encrypted relay, and there is no iPhone app yet.

## Features

- **Exact content previews:** Shows the real command, diff, file or email snapshotted so the approved content matches what runs.
- **Denial with feedback:** Lets you attach a note to a denial so the agent revises its plan and asks again.
- **Terminal, desktop and phone:** Decide from a terminal inbox, the desktop app or the Android app.
- **Dictated replies:** Speak feedback or answers, with offline transcription on desktop.
- **Scoped rules and timed mode:** Allow rules, presence routing and a timed YOLO mode, with auto-handled requests kept in history.
- **Self-hostable relay:** Run the end-to-end encrypted relay on your own Linux server for phone notifications.

## Good for

- Gate database migrations or production releases behind a human sign-off
- Review outgoing emails drafted by an agent before they are sent
- Approve shell commands or code changes proposed by coding agents like Claude Code or Cursor
- Let CI jobs or cron scripts wait for a human decision via the CLI or HTTP API

## Install

### Claude Code (Terminal)

```sh
claude mcp add handup -- npx -y https://github.com/gethandup/handup/releases/download/v0.1.13/handup_0.1.13.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "handup": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/gethandup/handup/releases/download/v0.1.13/handup_0.1.13.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "handup": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/gethandup/handup/releases/download/v0.1.13/handup_0.1.13.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "handup": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/gethandup/handup/releases/download/v0.1.13/handup_0.1.13.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "handup": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/gethandup/handup/releases/download/v0.1.13/handup_0.1.13.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "handup": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/gethandup/handup/releases/download/v0.1.13/handup_0.1.13.mcpb"
      ]
    }
  }
}
```

## FAQ

### Does handup run the actions after approval?

No. The README and product site state that handup records your decision and runs nothing.

### Is there an iPhone app?

No. The site says there is no iPhone app yet; an Android app is available.

### What does the personal license cost?

The pricing page lists a one-time $30 payment for a personal license, plus tax where applicable, after a 14-day free trial.

### Can a team share one license?

No. A personal license covers one person on their own machines, and team licensing is not offered yet.

### Is handup free?

No. handup is a paid product.

### How do I add handup to Claude Code?

Run this command in your terminal: claude mcp add handup -- npx -y https://github.com/gethandup/handup/releases/download/v0.1.13/handup_0.1.13.mcpb

### What are the best alternatives to handup?

The closest alternatives to handup are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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