Handset runs on your own machine — the client starts it, so there is no endpoint to ping. 15 installs a week from npm. Last commit 27 Aug 2026.
A business phone system for AI agents: send texts, place calls, read transcripts, buy numbers.
Today is the operative word: we check Handset every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add handset -e 'HANDSET_API_KEY=<HANDSET_API_KEY>' -- npx -y @handset/mcp
{
"mcpServers": {
"handset": {
"command": "npx",
"args": [
"-y",
"@handset/mcp"
],
"env": {
"HANDSET_API_KEY": "<HANDSET_API_KEY>"
}
}
}
}
[mcp_servers.handset]
command = "npx"
args = ["-y", "@handset/mcp"]
env = { HANDSET_API_KEY = "<HANDSET_API_KEY>" }
{
"mcpServers": {
"handset": {
"command": "npx",
"args": [
"-y",
"@handset/mcp"
],
"env": {
"HANDSET_API_KEY": "<HANDSET_API_KEY>"
}
}
}
}
{
"servers": {
"handset": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@handset/mcp"
],
"env": {
"HANDSET_API_KEY": "<HANDSET_API_KEY>"
}
}
}
}
Put your own value in place of
<HANDSET_API_KEY> (Handset API key. Use a test-mode key (hs_test_…) — simulated carrier, free. Live keys are refused unless HANDSET_ALLOW_LIVE=1).
The author’s registry entry marks it as required.
Optional settings from the registry entry, left out of the block above:
HANDSET_ALLOW_LIVE (Set to 1 to permit a live-mode key (the agent can then text and call real people at real cost)).
Place real phone calls, read transcripts, run a live interpreter and buy numbers.
Business phone and SMS for teams: calls, texts, transcripts, contacts and call flows.
Your business phone secretary: calls, transcripts, voicemail, texts and leads. Place calls too.
Read calls and texts, send SMS/MMS and place calls from the CallNode phone numbers you choose.
AI agent that calls, texts & emails businesses for you, then returns transcripts and replies.
Let AI agents place real phone calls from your verified number, with transcripts and recordings.
Business texting for AI agents: send texts, read threads, manage contacts and run campaigns.
AI voice agents that make real phone calls: single calls or campaigns, with transcripts and notes.
Answers built from our own checks of this server.