Skip to main content

custovox-calls

An MCP server that lets Claude analyze customer-service calls: sentiment, contact reasons, complaints, churn threats and agent promises, then suggest follow-up actions. Everything runs on your machine.

Built on callscope-ai.

Install

pip install custovox-calls              # transcripts (JSON segments) and demo mode
pip install "custovox-calls[whisper]"   # + local transcription of audio files (faster-whisper)

Quick start

# try it with 6 fictional calls, no audio needed
claude mcp add custovox-calls-demo --env CUSTOVOX_CALLS_DEMO=1 -- uvx custovox-calls

# your own calls
claude mcp add custovox-calls -- uvx --from "custovox-calls[whisper]" custovox-calls

Then ask: "Analyze ~/calls/2026-11-18-0912.wav", "What did customers complain about this month?", "Which calls had a churn threat?", "What should we do after call demo-1?"

Use in Claude Desktop

{
  "mcpServers": {
    "custovox-calls": {
      "command": "uvx",
      "args": ["--from", "custovox-calls[whisper]", "custovox-calls"]
    }
  }
}

Tools

Tool What it does
analyze_call(source, call_id, started_at, language) Analyze one call and save it. source: local audio file, http(s) URL to an audio file, local JSON file of segments [{start, end, text}], or a demo call (demo-1 … demo-6)
get_call_insights(since, until) Summary over a period: calls, minutes, mean customer sentiment, contact reasons, churn threats, most negative calls
search_feedback(query, speaker, since, until) Find what customers (or agents) said; case and accents ignored
suggest_actions(call_id) Manager alert, customer callback, CRM ticket, each with its reason and the sentence that triggered it. Sends nothing
send_action(action_id) Only when CUSTOVOX_CALLS_WEBHOOK_URL is set: posts one suggested action to your webhook (Slack, Zapier, Make, a CRM…)

Configuration

Variable Default Meaning
CUSTOVOX_CALLS_DB ~/.custovox-calls/calls.db SQLite file holding the analyzed calls
CUSTOVOX_CALLS_DEMO off 1: in-memory database preloaded with 6 fictional calls
CUSTOVOX_CALLS_WEBHOOK_URL none Enables send_action. The JSON payload has a text field, so Slack incoming webhooks display it as is
CUSTOVOX_CALLS_WHISPER_MODEL small faster-whisper model size

Privacy and limits

  • Call recordings and transcripts contain personal data. Audio is transcribed locally and the analysis is stored in a local SQLite file; nothing is sent anywhere, except by send_action to the webhook you configured.
  • Speaker detection (agent or customer), sentiment and contact reasons come from simple, inspectable rules in callscope-ai, in French and English. Use them to sort and prioritize calls, and check important cases by listening to them.

Development

pip install -e ".[test]" && pytest   # no network, no audio, no model

MIT licensed.

About

Built by CustoVox.ai. This free tool runs on your machine. The hosted platform at custovox.ai covers 5 languages, voice, text and images, with reports and integrations. From $89/month.

Metadata

Release files for custovox-calls 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for custovox-calls 0.1.1
File Size Uploaded Provenance Actions
custovox_calls-0.1.1.tar.gz 14.3 kB Without provenance Details for custovox_calls-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for custovox-calls 0.1.1
File Interpreter ABI Platform Actions
custovox_calls-0.1.1-py3-none-any.whl Python 3 none any Details for custovox_calls-0.1.1-py3-none-any.whl

Total release size: 26.9 kB

Release files / custovox_calls-0.1.1.tar.gz

Download URL custovox_calls-0.1.1.tar.gz
Size 14.3 kB
Tags Source
SHA-256 checksum
How to use checksums
e0d0469120ab084bc3077a42fa0139b2f0d51e2cc2df418fa35a5eb14f2f8566
BLAKE2b-256 checksum
How to use checksums
412a934e3881c872cfb1daf9acedd6b2a61a5e97e438d82c971eb49f9cb28437
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Release files / custovox_calls-0.1.1-py3-none-any.whl

Download URL custovox_calls-0.1.1-py3-none-any.whl
Size 12.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
053f16378426b6d09ee66441db9a8e8a857137096cc3f0a198ad3ec72d7cbdbd
BLAKE2b-256 checksum
How to use checksums
ac1418e85285af15b4619d153b8d5d74ea96573ac30a85746787ef1496b16b7b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Security for custovox-calls 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page