Spix-HQ/spix-mcp

> MCP server for Spix — give any MCP-compatible AI client a phone number, an inbox, and a voice.
spix-mcp is a standalone Model Context Protocol server that exposes Spix's communications infrastructure — phone calls, email, contacts, analytics — as MCP tools and resources.
Connect it to Claude Desktop, Cursor, or any MCP-compatible client and your AI can literally pick up the phone.
---
Install
The Spix CLI must also be installed and authenticated:
---
Quick setup: Claude Desktop
The fastest way — use the built-in installer from the Spix CLI:
This writes the correct config to ~/Library/Application Support/Claude/claude_desktop_config.json automatically. Restart Claude Desktop and Spix tools appear immediately.
Or configure manually in claude_desktop_config.json:
Get your API key from app.spix.sh/settings/api-keys.
---
Quick setup: Cursor
Or add to your Cursor MCP config manually with the same JSON structure as above.
---
What your AI can do
Once connected, your AI client has access to **43 tools** (safe profile) or **49 tools** (full profile) across all Spix capabilities:
Phone calls
| Tool | Description |
|------|-------------|
| spix_call_create | Make an outbound AI phone call |
| spix_call_show | Get call status and metadata |
| spix_call_list | List recent calls |
| spix_call_transcript | Get full call transcript |
| spix_call_summary | Get call summary + extracted fields |
| spix_call_cancel | Cancel an in-progress call *(full profile)* |
Email
| Tool | Description |
|------|-------------|
| spix_email_send | Send an email from your Spix inbox |
| spix_email_reply | Reply to a received email |
| spix_email_list | List emails in your inbox |
SMS
| Tool | Description |
|------|-------------|
| spix_sms_send | Send an SMS message |
| spix_sms_list | List SMS messages |
| spix_sms_thread | Get an SMS conversation thread |
Playbooks
| Tool | Description |
|------|-------------|
| spix_playbook_create | Create a call or SMS playbook |
| spix_playbook_list | List all playbooks |
| spix_playbook_show | Get playbook details |
| spix_playbook_update | Update playbook settings |
| spix_playbook_clone | Clone an existing playbook |
| spix_playbook_pause | Pause a playbook |
| spix_playbook_resume | Resume a paused playbook |
| spix_playbook_delete | Delete a playbook *(full profile)* |
| spix_playbook_voice_list | List available voices |
| spix_playbook_language_list | List supported languages |
| spix_playbook_emotion_list | List available emotions |
| spix_playbook_rule_add | Add a rule to a playbook |
| spix_playbook_rule_list | List playbook rules |
| spix_playbook_rule_remove | Remove a playbook rule |
| spix_playbook_rule_clear | Clear all playbook rules |
Contacts
| Tool | Description |
|------|-------------|
| spix_contact_create | Create a contact |
| spix_contact_show | Get contact details |
| spix_contact_list | List contacts |
| spix_contact_history | Get communication history with a contact |
| spix_contact_summary | Get AI-generated contact summary |
| spix_contact_tag | Add tags to a contact |
Phone numbers
| Tool | Description |
|------|-------------|
| spix_phone_list | List your phone numbers |
| spix_phone_show | Get phone number details |
| spix_phone_bind | Bind a number to a playbook |
| spix_phone_unbind | Remove a binding |
| spix_phone_release | Release a phone number *(full profile)* |