Cv MCP Server

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.