# Customermates

> Customermates is a freemium MCP server for sales and crm. Open-source CRM that Claude, ChatGPT and Cursor can read and write through MCP. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API, self-hosted
- **Website:** https://customermates.com/en/docs/mcp
- **Repository:** https://github.com/customermates/customermates
- **MCP Registry name:** io.github.benjiwagner/customermates
- **Categories:** sales and CRM
- **Listing updated:** 2026-11-14

## About

Customermates serves its MCP endpoint at /api/v1/mcp on whatever address you open the CRM at, and each workspace also gets its own locked URL ending in /mcp/w/ followed by the workspace ID. A connected client discovers the CRM tools on its own through tools/list.

There are two ways in. Claude on the web, desktop and mobile, and ChatGPT, use a custom connector with OAuth sign-in. CLI and editor clients such as Claude Code, Codex, Cursor and Gemini CLI send a 64-character API key in the x-api-key header. A key carries the permissions of the user who created it, and the docs say there is no per-key scoping.

The docs recommend MCP when an AI should work the CRM itself, and OpenAPI when an engineer already knows which endpoint to call. The same requests must send an Accept header covering JSON and event streams or the server answers 406.

## Features

- **Native MCP endpoint:** One streamable HTTP endpoint per instance, plus a workspace-scoped URL.
- **OAuth custom connector:** Claude and ChatGPT connect by pasting the URL and approving, with no key to manage.
- **API key access:** CLI and editor clients authenticate with a 64-character key in a header.
- **Records, inbox and knowledge:** The CRM exposes records, an inbox and company knowledge to agents.
- **Self-host option:** The open-source edition can be self-hosted for free.

## Good for

- Let an assistant update CRM records after a call
- Ask an agent to summarise a contact's history
- Connect Claude Code or Cursor to a sales workspace
- Restrict an agent to one workspace via its own URL

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http customermates https://customermates.com/api/v1/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://customermates.com/api/v1/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "customermates": {
      "url": "https://customermates.com/api/v1/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "customermates": {
      "serverUrl": "https://customermates.com/api/v1/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## FAQ

### How do Claude and ChatGPT connect?

Through a custom connector: paste the MCP URL, sign in and approve.

### How do CLI clients authenticate?

By sending a 64-character API key in the x-api-key header.

### Can I scope a key to part of the CRM?

The docs say a key carries the creating user's permissions and has no per-key scoping.

### What happens if the Accept header is missing?

The endpoint returns 406 Not Acceptable.

### Is Customermates free?

Customermates has a free plan, with paid plans for more usage or features.

### How do I add Customermates to Claude Code?

Run this command in your terminal: claude mcp add --transport http customermates https://customermates.com/api/v1/mcp

### What are the best alternatives to Customermates?

The closest alternatives to Customermates are Calven, CompanyData, MisarReach MCP Server, NeuralVerge and ZUUZ.

## Alternatives

- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [ZUUZ](https://ai-powered.com/mcp/zuuz): ZUUZ is an MCP server for sales and crm.
- [Fuse](https://ai-powered.com/mcp/fuse-2): Fuse is a freemium MCP server for sales and crm.
- [Gender-API.com](https://ai-powered.com/mcp/gender-api-com): Gender-API.com is a freemium MCP server for analytics and data.
- [Dialvett: Bulk Phone Number Validator & Carrier Lookup](https://ai-powered.com/mcp/dialvett-bulk-phone-number-validator-and-carrier-lookup): Dialvett: Bulk Phone Number Validator & Carrier Lookup is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/customermates
