NestDaddy

Handset

io.github.handset-hq/handset · v0.1.1

A business phone system for AI agents: send texts, place calls, read transcripts, buy numbers.

Connect Runs on your machine

Terminal
claude mcp add handset -e HANDSET_API_KEY=<HANDSET_API_KEY> -e HANDSET_ALLOW_LIVE=<HANDSET_ALLOW_LIVE> -- npx -y @handset/[email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "handset": {
      "command": "npx",
      "args": [
        "-y",
        "@handset/[email protected]"
      ],
      "env": {
        "HANDSET_API_KEY": "<HANDSET_API_KEY>",
        "HANDSET_ALLOW_LIVE": "<HANDSET_ALLOW_LIVE>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "handset": {
      "command": "npx",
      "args": [
        "-y",
        "@handset/[email protected]"
      ],
      "env": {
        "HANDSET_API_KEY": "<HANDSET_API_KEY>",
        "HANDSET_ALLOW_LIVE": "<HANDSET_ALLOW_LIVE>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "handset": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@handset/[email protected]"
      ],
      "env": {
        "HANDSET_API_KEY": "<HANDSET_API_KEY>",
        "HANDSET_ALLOW_LIVE": "<HANDSET_ALLOW_LIVE>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
HANDSET_API_KEY
Required, secret
Handset API key. Use a test-mode key (hs_test_…) — simulated carrier, free. Live keys are refused unless HANDSET_ALLOW_LIVE=1.
HANDSET_ALLOW_LIVE
Optional
Set to 1 to permit a live-mode key (the agent can then text and call real people at real cost).

Details

Package@handset/[email protected] (NPM, stdio)
First published18 Aug 2026
Last updated18 Aug 2026
Registry nameio.github.handset-hq/handset

More ai and media servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.