Skip to content
MCP server

handup

Approval inbox where AI agents ask a human before risky actions like migrations or emails

Runs locallyStatus and history
Install
Pricing
Paid
Platforms
Linux, macOS, Windows
Runs
Locally
Version
0.1.13
Listing updated
today

About handup

handup is a paid MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "handup": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/gethandup/handup/releases/download/v0.1.13/handup_0.1.13.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "handup": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/gethandup/handup/releases/download/v0.1.13/handup_0.1.13.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

What it does

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

Pricing

Paid

Free 14-day trial; personal license $30 one-time, plus tax where applicable

Prices change. Check gethandup.dev before you buy.

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

How AIPoweredBot checks servers

Alternatives to handup

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 467K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.8K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    • Remote
    • Open source
    • 34.6K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools