PhononX/cv-mcp-server

A Model Context Protocol (MCP) server implementation for integrating with Carbon Voice's API, providing AI assistants with comprehensive tools for voice messaging, conversations, and workspace management.
** Carbon Voice**: https://getcarbon.app
** API**: https://api.carbonvoice.app/docs
Features
- **Message Management**: Create, list, and retrieve voice messages, conversation messages, and direct messages
- **User Operations**: Search and retrieve user information
- **Conversation Management**: Access and manage conversations and their participants
- **Folder Operations**: Create, organize, move, and manage folders and their contents
- **Workspace Administration**: Get workspace information
- **AI Actions**: Run AI prompts and retrieve AI-generated responses
- **Action Items**: Create, assign, and track action items, including AI extraction from messages
- **Search & Notifications**: Find messages by notified or heard state, and read the inbox with its unread count
- **Message Share Links**: Create and look up shareable links to messages
- **Attachment Support**: Add link attachments to messages
- **Response Narrowing**: An optional response_fields projection on most read tools, to keep unwanted payload out of the agent's context
Security & Compliance
This server fully complies with MCP Security Best Practices:
- **OAuth 2.1 Authentication**: Secure authorization flow with proper token handling
- **HTTPS Enforcement**: All remote endpoints served over HTTPS
- **Session Security**: Cryptographically secure session management
- **Input Validation**: Comprehensive validation of all user inputs
- **Rate Limiting**: Built-in protection against abuse
For security concerns, please contact: devsupport@phononx.com
Prerequisites
For Stdio Transport (Local Installation)
**Required:**
1. **Carbon Voice API Key** - Contact the Carbon Voice development team to request your API key:
- **📧 Contact**: devsupport@phononx.com
- **📧 Subject**: "Request API key for MCP Server"
2. **npx Installation** - You must have npx installed on your system. npx comes bundled with Node.js (version 14.8.0 or later). If you don't have Node.js installed, you can download it from nodejs.org.
To verify your installation, run:
For HTTP Transport (Remote)
**Required:**
1. **Nothing!** - No additional prerequisites are required. The HTTP transport version runs entirely in the cloud and uses OAuth2 authentication, so you don't need an API key or npx installed.
Configuration
Quick Overview
| Client | HTTP Transport (Remote) | Stdio Transport (Local) |
| ------------------ | ----------------------- | ----------------------- |
| **Cursor** | ✅ Recommended | ✅ Available |
| **Claude Desktop** | ✅ Recommended | ✅ Available |
_HTTP Transport is recommended for easier setup and enhanced security._
For Cursor
HTTP Transport (Remote)
1. Open Cursor
2. Go to **Cursor Settings** > **Features** > **Model Context Protocol**
3. Add a new MCP server configuration:
4. Save and restart Cursor
The first time you use it, Cursor will guide you through the OAuth2 authentication process.
Stdio Transport (Local Installation)
If you prefer to run the MCP server locally with API key authentication:
1. Open Cursor
2. Go to **Cursor Settings** > **Features** > **Model Context Protocol**
3. Add a new MCP server configuration:
4. Replace "your_api_key_here" with your actual Carbon Voice API key
5. Save and restart Cursor
For Claude Desktop
HTTP Transport (Remote)
Setting up Carbon Voice in Claude Desktop is straightforward! Here's how to do it:
1. **Open Claude Desktop** and navigate to **Search and Tools**
2. **Go to Manage Connectors** and click **"Add custom connector"**
3. **Fill in the connector details**:
- **Name**: Give it a friendly name like "Carbon Voice"
- **Remote MCP Server URL**: Enter https://mcp.carbonvoice.app
4. **Save your connector**
5. **Click Connect**:
The first time you use it, Claude will guide you through the OAuth2 authentication process. You'll just need to sign in with your Carbon Voice account and grant permissions. After that, you're all set!
Stdio Transport (Local Installation)
If you prefer to run the MCP server locally with API key authentication:
1. Open your Claude Desktop configuration file:
- **macOS**: ~/Library/Application Support/Claude/claude_desktop_config.json
- **Windows**: %APPDATA%\Claude\claude_desktop_config.json
2. Add the Carbon Voice MCP server configuration:
3. Replace "your_api_key_here" with your actual Carbon Voice API key