A business phone system for AI agents: send texts, place calls, read transcripts, buy numbers.
Connect Runs on your machine
claude mcp add handset -e HANDSET_API_KEY=<HANDSET_API_KEY> -e HANDSET_ALLOW_LIVE=<HANDSET_ALLOW_LIVE> -- npx -y @handset/[email protected]
{
"mcpServers": {
"handset": {
"command": "npx",
"args": [
"-y",
"@handset/[email protected]"
],
"env": {
"HANDSET_API_KEY": "<HANDSET_API_KEY>",
"HANDSET_ALLOW_LIVE": "<HANDSET_ALLOW_LIVE>"
}
}
}
}
{
"mcpServers": {
"handset": {
"command": "npx",
"args": [
"-y",
"@handset/[email protected]"
],
"env": {
"HANDSET_API_KEY": "<HANDSET_API_KEY>",
"HANDSET_ALLOW_LIVE": "<HANDSET_ALLOW_LIVE>"
}
}
}
}
{
"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
| Name | Description |
|---|---|
HANDSET_API_KEYRequired, 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_LIVEOptional | 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 published | 18 Aug 2026 |
| Last updated | 18 Aug 2026 |
| Registry name | io.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.
