Skip to main content

Overview

Clerk Chat provides an MCP (Model Context Protocol) server that lets you send messages, manage contacts, and run campaigns from any MCP-compatible client. The MCP server is hosted at:

Prerequisites

  • A Clerk Chat account with an active workspace
  • An MCP-compatible client (e.g., Claude Code, Claude Desktop, or any other MCP client)

Authentication

The Clerk Chat MCP server uses OAuth for authentication. The first time you invoke a tool, your client will open a browser window to authenticate with your Clerk Chat account. After signing in, you’ll be redirected back and the session will be active.

Claude Code Setup

Add the Clerk Chat MCP server to Claude Code:
To verify the connection, run:
You should see Authentication successful. Connected to clerk. in the output.

Available Tools

Once connected, the following tools are available:

send_message

Send an SMS/MMS message from a Clerk Chat inbox.

get_messages

Retrieve messages for the active team with optional filtering.

create_contact

Create a new contact in your workspace.

update_contact

Update an existing contact.

delete_contact

Delete a contact by ID.

create_contacts_batch

Create multiple contacts at once.

create_campaign

Send a message to all contacts in a list.

Examples

Send a message:
Send a message from +15551234567 to +15559876543 saying “Your appointment is confirmed for tomorrow at 2pm”
Check recent messages:
Show me the last 10 messages from inbox 5d0e8d03-d09f-47e5-8017-4d00cbf737f4
Create a contact:
Create a contact for Jane Smith with phone +15551234567 and email jane@example.com

Troubleshooting