# CosVoice MCP server

> Give your AI assistant a real US phone number and email address to place and answer calls and send written call summaries

- Listing: https://mcp.tc/i/cosvoice
- Connect: use the server's own URL `https://cosvoice.com/mcp` (OAuth sign-in at the server); clients connect to it directly. The listing link is a page, not an MCP endpoint.
- Type: remote (Streamable HTTP)
- Auth: OAuth sign-in
- Category: [Communication & Meetings](https://mcp.tc/c/communication)
- Vendor: CosVoice
- Homepage: <https://cosvoice.com/>

## About

CosVoice gives an AI assistant a real phone number and its own email address. The assistant can call restaurants, contractors and offices on your behalf, take calls back, and send a written summary of each call to your inbox.

It runs as a hosted Streamable HTTP endpoint at cosvoice.com/mcp. Access needs a CosVoice account, which is a paid plan (from $29 per month after a 7-day trial with a card required to start). The endpoint accepts OAuth tokens and supports dynamic client registration.

## What it can do

- Place phone calls on your behalf
- Answer incoming calls as your assistant
- Get a written summary of each call by email
- Use a dedicated phone number and email address
- Receive call.completed webhooks with transcripts

## Tools (27)

- `get_account`: Who this key belongs to and whether a line exists yet. (read-only)
- `search_numbers`: Find available phone numbers in a US area code for a new line. (read-only)
- `create_line`: Set up the phone line: claim a number (pick one from search\_numbers or just give an area code), name the persona, and register the owner's mobile. (can modify or delete data)
- `get_line`: Number, email identity, persona, owner, and minutes remaining this period. (read-only)
- `place_call`: Have the line call a real number and hold a live voice conversation on the owner's behalf. (can modify or delete data)
- `book_reservation`: Reserve a table by phone: the line calls the venue, negotiates the time, answers the host's questions (name, callback, email), records policies, and never pays. (can modify or delete data)
- `list_reservations`: Recent reservation requests with their status and the venue's stated policies. (read-only)
- `get_call`: Status, structured notes, outcome, transcript, and annotations for one call. (read-only)
- `list_calls`: Recent calls with summaries, newest first. (read-only)
- `annotate_call`: Attach a note to a call (what you did about it, a decision, context for the owner). (can modify or delete data)
- `send_text`: Send an SMS from the line's number. (can modify or delete data)
- `ack_instructions`: Mark owner instructions (texts the owner sent to the line) as handled so they stop being attached to tool results. (can modify or delete data)
- `list_messages`: Recent texts to and from the line. (read-only)
- `list_emails`: Email received at and sent from the line's address, newest first (direction inbound\|outbound), with forwarding status. (read-only)
- `get_email`: Full text of one email the line received. (read-only)
- `send_email`: Send an email from the line's own address (handle@cosvoice.com). (can modify or delete data)
- `forward_email`: Forward one received email to one of the line's own inboxes: its forwarding, notification or Bot inbox, or the owner's sign-in address (defaults to the forwarding inbox). (can modify or delete data)
- `list_contacts`: Owner, approved, VIP, and blocked numbers. (read-only)
- `add_contact`: Teach the line a number. (can modify or delete data)
- `remove_contact`: Remove a number from the contacts list (not the owner). (can modify or delete data)
- `get_settings`: Persona, voice, greeting, standing instructions, owner, notifications, forwarding, webhook, Bot push, SMS consent. (read-only)
- `update_settings`: Change any of: name, voice, greeting, instructions, owner\_name, owner\_phone, timezone, notify\_email, agent\_email, morning\_brief (daily digest on/off), morning\_brief\_hour (0–23 local), forward\_email, forward\_mode… (can modify or delete data)
- `set_bot_push`: Have CosVoice start YOU the moment something arrives, instead of you polling. (can modify or delete data)
- `set_webhook`: Set (or clear with an empty url) the HTTPS webhook that receives call.completed, message.received, and email.received. (can modify or delete data)
- `list_history`: Unified history of calls, texts, and email with optional search. (read-only)
- `recent_activity`: Everything since a timestamp: calls, texts, emails. (read-only)
- `list_integrations`: Partner integrations available through this line (groceries, food, reservations, travel…), with status and connect links. (read-only)

## Example prompts

- "Call Osteria Mozza and book a table for two this Friday at 7:30."
- "Call my plumber back and get the quote for the water heater."
- "Summarize the last call my assistant took."
- "Phone the dentist's office and ask for the next available cleaning."

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport http cosvoice https://cosvoice.com/mcp
```

2. Start Claude Code, type `/mcp`, pick **cosvoice** and choose **Authenticate**. A browser window opens for the CosVoice sign-in.

Add `--scope user` to make it available in every project, not just this one.

### Claude Desktop

1. Open **Customize → Connectors**, click **+ Add**, then **Add custom connector**.

2. Name it **CosVoice** and paste this URL:

```url
https://cosvoice.com/mcp
```

3. Click **Add**, then **Connect**, and sign in when CosVoice asks.

Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.

### claude.ai

1. Open the connector form on claude.ai. This button fills in the name and URL for you:

[Add to claude.ai](<https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=CosVoice&connectorUrl=https%3A%2F%2Fcosvoice.com%2Fmcp>) (opens connector settings)

2. Check that the URL reads `https://cosvoice.com/mcp` and click **Add**.

3. Click **Connect** and sign in when CosVoice asks.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**.

### ChatGPT

1. On chatgpt.com, go to **Plugins**, select **+**, then **Add custom MCP server**.

2. Enter a name for the server.

3. Under **Connection**, paste `https://cosvoice.com/mcp` as the server URL, then for authentication choose **OAuth**. ChatGPT sends you to CosVoice to sign in.

4. Check **I understand and want to continue**, then select **Create as a plugin**.

Whether you can add a custom MCP server depends on your ChatGPT plan and your workspace permissions (in Business workspaces, admins and owners can).

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=cosvoice&config=eyJ1cmwiOiJodHRwczovL2Nvc3ZvaWNlLmNvbS9tY3AifQ%3D%3D>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "cosvoice": {
      "url": "https://cosvoice.com/mcp"
    }
  }
}
```

Cursor shows **Needs authentication** next to the server. Click the button beside it to sign in.

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=cosvoice&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fcosvoice.com%2Fmcp%22%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"cosvoice","type":"http","url":"https://cosvoice.com/mcp"}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "cosvoice": {
      "type": "http",
      "url": "https://cosvoice.com/mcp"
    }
  }
}
```

VS Code asks you to sign in the first time the server starts.

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "cosvoice": {
      "serverUrl": "https://cosvoice.com/mcp"
    }
  }
}
```

2. Refresh the MCP server list in Cascade and sign in when asked.

Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers.

### Codex

```bash
codex mcp add cosvoice --url https://cosvoice.com/mcp
codex mcp login cosvoice
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.cosvoice]
url = "https://cosvoice.com/mcp"
```

### Gemini CLI

```bash
gemini mcp add --transport http cosvoice https://cosvoice.com/mcp
```

Then, inside Gemini CLI, run `/mcp auth cosvoice` to sign in.

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file.

```json
{
  "mcpServers": {
    "cosvoice": {
      "type": "http",
      "url": "https://cosvoice.com/mcp"
    }
  }
}
```

Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE.

Client only starts local servers? Bridge it with `npx -y mcp-remote https://cosvoice.com/mcp`.

## Recent changes

- 2026-11-08 17:53 UTC: 1 tool changed. Source: automatic check. Changed: set\_bot\_push.
- 2026-10-27 10:08 UTC: Tracking started: 27 tools read. Source: automatic check.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/cosvoice#history (Atom feed: https://mcp.tc/i/cosvoice/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 1.0.0
- MCP protocol version: 2025-06-18
- Last checked: 2026-11-17 (reachable, asks for credentials)
- Listed: 2026-10-27
- Updated: 2026-11-08

---
Source: https://mcp.tc/i/cosvoice (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
