# ClerkChat

> ClerkChat is a freemium MCP server for communication. Create, train and run ClerkChat support agents from Claude, ChatGPT or Cursor. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** Web, API, whatsapp, telegram, Slack
- **Website:** https://clerkchat.co
- **Repository:** https://github.com/clerkchatco-public/clerkchat-mcp
- **MCP Registry name:** co.clerkchat/clerkchat
- **Categories:** communication, sales and CRM
- **Listing updated:** 2026-11-15

## About

This hosted server lets an assistant work inside a ClerkChat workspace. ClerkChat itself is an AI agent that answers customers on WhatsApp, Instagram, Messenger, Telegram, a website widget and a hosted help page, trained on a business's site, files, Google Docs and Sheets, Notion pages and YouTube videos. The server covers the admin side of that: building agents, feeding them knowledge, connecting channels and reading conversations.

Example prompts from the README include creating a support agent trained on a URL, adding a PDF, listing unread WhatsApp conversations and drafting replies, taking over a chat, exporting leads from an automation and counting conversations per agent over 30 days. Documents of up to 8 MiB (PDF, TXT, MD, CSV, TSV, JSON, XLS, XLSX) go through MCP with no browser upload.

Authentication is OAuth 2.1 with dynamic client registration and PKCE, with read, write and offline scopes. At sign-in you choose which workspaces the assistant may reach, and you can revoke a client from the MCP page in the dashboard. The repository holds documentation only, since the server is hosted by ClerkChat.

## Features

- **Agent management:** Create, update, duplicate, archive and transfer support agents.
- **Knowledge sources:** Add websites, text and documents of up to 8 MiB.
- **Channel connections:** Connect Telegram, WhatsApp and Slack and check channel status.
- **Conversation handling:** Read, reply to and take over customer conversations.
- **Leads and analytics:** Export leads and pull conversation analytics.
- **Workspace-scoped OAuth:** Choose which workspaces an assistant can access and revoke it later.

## Good for

- Spin up a support agent from a website URL in chat
- Add a PDF or FAQ to an agent's knowledge
- Review and reply to unread WhatsApp conversations
- Export weekly leads from an automation
- Compare conversation volume across agents

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http clerkchat https://mcp.clerkchat.co/mcp
```

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

```sh
https://mcp.clerkchat.co/mcp
```

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

```json
{
  "mcpServers": {
    "clerkchat": {
      "url": "https://mcp.clerkchat.co/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "clerkchat": {
      "type": "http",
      "url": "https://mcp.clerkchat.co/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "clerkchat": {
      "serverUrl": "https://mcp.clerkchat.co/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "clerkchat": {
      "type": "http",
      "url": "https://mcp.clerkchat.co/mcp"
    }
  }
}
```

## Tools

- `list_workspaces`: ClerkChat workspace tool: list workspaces.
- `list_agents`: ClerkChat workspace tool: list agents.
- `get_agent`: ClerkChat workspace tool: get agent.
- `create_agent`: ClerkChat workspace tool: create agent.
- `update_agent`: ClerkChat workspace tool: update agent.
- `duplicate_agent`: ClerkChat workspace tool: duplicate agent.
- `archive_agent`: ClerkChat workspace tool: archive agent.
- `transfer_agent`: ClerkChat workspace tool: transfer agent.
- `share_agent_template`: ClerkChat workspace tool: share agent template.
- `list_sources`: ClerkChat workspace tool: list sources.
- `add_website_source`: ClerkChat workspace tool: add website source.
- `add_text_source`: ClerkChat workspace tool: add text source.
- `add_document_source`: ClerkChat workspace tool: add document source.
- `process_source`: ClerkChat workspace tool: process source.
- `get_channel_status`: ClerkChat workspace tool: get channel status.
- `connect_telegram`: ClerkChat workspace tool: connect telegram.
- `connect_whatsapp_cloud_api`: ClerkChat workspace tool: connect whatsapp cloud api.
- `list_slack_channels`: ClerkChat workspace tool: list slack channels.

## FAQ

### Do I need to install anything?

No. The server is hosted at mcp.clerkchat.co/mcp, and you only add it as a connector.

### How does authentication work?

OAuth 2.1 with dynamic client registration and PKCE. You sign in and choose workspaces.

### Do I need a paid plan?

A ClerkChat account is required, and the pricing page lists a free plan with no card.

### Which clients are covered?

The README gives steps for Claude, Claude Code, ChatGPT and Cursor, and any client with remote OAuth support.

### Is ClerkChat free?

ClerkChat has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

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

Run this command in your terminal: claude mcp add --transport http clerkchat https://mcp.clerkchat.co/mcp

### What are the best alternatives to ClerkChat?

The closest alternatives to ClerkChat are Calven, CompanyData, MisarReach MCP Server, NeuralVerge and BoardAgent.

## 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.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ZUUZ](https://ai-powered.com/mcp/zuuz): ZUUZ is an MCP server for sales and crm.

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