# PhononX/cv-mcp-server [Health: Active]

**Category:** 💬 Communication  
**Repository:** https://github.com/PhononX/cv-mcp-server  
**GitHub Stars:** 10  
**npm Downloads (last month):** 174  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/phononx-cv-mcp-server

## Description
MCP Server that connects AI Agents to Carbon Voice. Create, manage, and interact with voice messages, conversations, direct messages, folders, voice memos, AI actions and more in Carbon Voice.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "cv-mcp-server": {
    "command": "npx",
    "args": ["-y","@carbonvoice/cv-mcp-server"],
    "env": {
      "CARBON_VOICE_API_KEY": "",
      "LOG_LEVEL": "",
      "LOG_DIR": ""
    }
  }
}
```

**Requires environment variables:** `CARBON_VOICE_API_KEY`, `LOG_LEVEL`, `LOG_DIR` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What PhononX/cv-mcp-server MCP server does

PhononX/cv-mcp-server MCP server exposes Carbon Voice operations to MCP-compatible AI assistants. It covers voice messages, conversation messages, direct messages, voice memos, users, conversations, folders, workspace information, link attachments, and Carbon Voice AI actions.

The available operations include reading recent or filtered messages, retrieving a message by ID, sending messages to conversations or users, creating voice memos, and attaching links to existing messages. Agents can also search for users by phone number or email, inspect conversation participants, and access workspace folder information. Folder management includes creation, renaming, deletion, moving folders, and moving messages into folders.

## How it works

The project offers two transport modes. The remote mode uses the hosted endpoint at `https://mcp.carbonvoice.app`; it runs in the cloud and starts an OAuth 2.1 authorization flow when a client connects. The local mode runs through stdio using the npm package `@carbonvoice/cv-mcp-server` and authenticates with a Carbon Voice API key.

The server communicates with Carbon Voice's API on behalf of the connected assistant. Remote connections are served over HTTPS and use session security, input validation, and rate limiting according to the supplied project documentation. Message listing is limited to a maximum 31-day date range, while conversation listing covers the previous six months.

## Setup and configuration

For the remote version, configure the MCP client with `https://mcp.carbonvoice.app`. No local runtime or API key is listed as necessary for this mode; the user completes OAuth2 sign-in and grants permissions through the client.

For a local installation, use Node.js with `npx` and request a Carbon Voice API key from the Carbon Voice development team. Configure the server with `CARBON_VOICE_API_KEY`, then run `npx -y @carbonvoice/cv-mcp-server`. `LOG_LEVEL` can be set to `info`, `debug`, `warn`, or `error`; the default is `info`. `LOG_DIR` changes the directory used for `combined.log` and `error.log`, which otherwise defaults to `/tmp/cv-mcp-server/logs`.

Cursor and Claude Desktop both have documented configurations for the hosted and stdio transports. The remote transport is identified in the README as the recommended option for those clients.

## Tools and capabilities

PhononX/cv-mcp-server MCP server groups its tools into the following areas:

- Messages: list, retrieve, send to conversations, send directly to users or groups, create voice memos, and add link attachments.
- Users: retrieve a user by ID and search for one or more users using identifiers such as phone numbers or email addresses.
- Conversations: list conversations, retrieve conversation details, and inspect participants.
- Folders: list roots, retrieve folders and their messages, create or rename folders, delete folders, move folders, and move messages.
- Workspace: retrieve basic workspace information and folder message counts.
- AI actions: list available Carbon Voice AI prompts or actions and run an AI action.

Folder deletion is a destructive operation, so agents should use that tool only when the requested change is intentional. The supplied tool list does not document permissions or result schemas beyond the operation descriptions.

_Full upstream README: https://allmcps.com/mcp/phononx-cv-mcp-server/readme_