Crisp MCP server

Connect Crisp to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Crisp MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the remove person tool in Crisp
  • Use the get conversation tool in Crisp
  • Use the list people tool in Crisp
  • Use the send message tool in Crisp
  • Use the create person tool in Crisp
  • Use the get messages tool in Crisp

Supported Tools

remove_person

Remove Person

Permanently remove a contact profile from the Crisp CRM. This action is irreversible.

get_conversation

Get Conversation

Retrieve full details of a specific conversation by its session ID, including metadata, state, routing, messages preview, and visitor information.

list_people

List People

List and search contact profiles in the Crisp CRM. Supports searching by name, email, or segment. Returns paginated contact profiles.

send_message

Send Message

Send a message in a Crisp conversation. Supports text messages, notes (internal), file attachments, and other message types. Messages can be sent as an operator or as a user.

create_person

Create Person

Create a new contact profile in the Crisp CRM. At minimum, provide an email or nickname. Returns the new people ID.

get_messages

Get Messages

Retrieve messages from a conversation. Returns the most recent messages by default. Use timestampBefore for pagination to load older messages.

list_conversations

List Conversations

List and search conversations in your Crisp workspace. Supports filtering by status (unread, resolved, assigned), date range, inbox, and text/segment search. Returns paginated conversation summaries with metadata.

update_conversation

Update Conversation

Update a conversation's metadata, state, routing assignment, or block status. Combine multiple updates in a single call — set the nickname, assign an operator, change state to resolved, and add segments all at once.

manage_website_settings

Manage Website Settings

Get or update the Crisp website (workspace) settings. When no settings are provided, returns the current configuration. When settings are provided, updates them. Settings include chatbox appearance, contact info, email preferences, and more.

create_conversation

Create Conversation

Create a new conversation in your Crisp workspace. Returns the new session ID. You can optionally set initial metadata such as nickname, email, subject, and segments after creation using the Update Conversation tool.

batch_conversation_actions

Batch Conversation Actions

Perform bulk actions on multiple conversations at once. Resolve, mark as read, or remove multiple conversations in a single operation.

list_helpdesk_articles

List Helpdesk Articles

List helpdesk knowledge base articles for a specific locale. Returns paginated article summaries. Use this to browse your knowledge base or find articles to update.

get_website_availability

Get Website Availability

Check the current online/offline availability status of the Crisp website (workspace). Returns whether the support team is currently available.

manage_helpdesk_article

Manage Helpdesk Article

Create, update, or delete a helpdesk knowledge base article. Articles are organized by locale for multi-language support. You can set the title, content, category, featured status, and order.

remove_conversation

Remove Conversation

Permanently remove a conversation from your Crisp workspace. This action is irreversible.

update_person

Update Person

Update an existing contact profile in the Crisp CRM. Change email, nickname, phone, segments, custom data, and subscription status in a single call.

list_operators

List Operators

List all operators (team members) of the Crisp workspace. Returns operator details including user ID, email, role, and availability. Useful for finding operator IDs to assign conversations.

get_person

Get Person

Retrieve a full contact profile from the Crisp CRM by people ID. Returns profile details, custom data, segments, and subscription status.

manage_message_status

Manage Message Status

Mark Crisp conversation messages as read, unread, or delivered. Use message fingerprints from Get Messages or Send Message for fingerprint-specific acknowledgements.

list_conversation_activity

List Conversation Activity

List pages viewed, custom events, or file messages for a Crisp conversation. This gives support context beyond the message transcript.

list_helpdesk_locales

List Helpdesk Locales

List helpdesk knowledge base locales configured for the Crisp workspace. Use this to find locale IDs before listing or managing articles.

list_inboxes

List Inboxes

List Crisp website inboxes. Use this to find inbox IDs for conversation filtering or moving conversations between inboxes.

Connect Crisp to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Crisp in Metorial. In your Metorial portal, enable the Crisp MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Crisp tools.

Run Crisp through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Crisp and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Crisp tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Crisp

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Apolloio

Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.

Hubspot

Create, read, update, and delete CRM objects including contacts, companies, deals, tickets, and custom objects. Manage associations between CRM records. Track engagements such as calls, emails, meetings, notes, and tasks. Send transactional and marketing emails, manage campaigns, and handle subscription preferences. Build and manage marketing workflows, sequences, and automation actions. Manage CMS content including blog posts, landing pages, and HubDB tables. Handle commerce data including products, orders, invoices, quotes, and payments. Create and manage contact lists for segmentation. Configure deal, ticket, and order pipelines with custom stages. Search and filter CRM records. Bulk import and export CRM data. Manage users, teams, and account settings.

Calendly

List, retrieve, and cancel scheduled events. Book meetings programmatically on behalf of invitees using available time slots. Retrieve event types and their configurations. Query user availability, available time slots, busy times, and availability schedules. Create single-use scheduling links with optional overrides. List and manage invitees, mark no-shows, and access custom question responses and UTM tracking data. Manage organization memberships, invite or remove users. Retrieve routing form configurations and submissions. Subscribe to webhooks for new bookings, cancellations, and routing form submissions.

Linkedin

Authenticate LinkedIn members with OpenID Connect, fetch the authenticated member profile, and create self-serve LinkedIn shares with text, article links, and uploaded images. Organization and Community Management workflows should move to a separate slate because LinkedIn restricts combining those products in one app.

Mailchimp

Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.

Technical notes for Crisp

Manage customer conversations, contacts, and support operations across multiple channels. Send and receive messages (text, files, audio, carousels) in conversations, assign conversations to operators, and track conversation states. Create, update, search, and manage contact profiles with custom data, events, and subscription status. Build and manage helpdesk knowledge base articles with multi-language support. Create and manage marketing campaigns including one-shot and automated campaigns. Configure website workspace settings, chatbox appearance, and operator roles. Track visitors in real-time, monitor website availability status, and access analytics for messaging, contacts, ratings, and campaigns. Receive real-time events via webhooks or WebSocket for session changes, messages, campaigns, and more.

Frequently asked questions

Common questions about connecting Crisp to AI agents with Metorial.

  1. How many tools does the Crisp MCP server have?
    The Crisp MCP server exposes 22 tools, including Remove Person, Get Conversation, List People. Each one is governed and traced through Metorial.
  2. Crisp exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Crisp MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Crisp and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Crisp MCP server yourself or use the hosted gateway.

Connect Crisp to production AI agents

See how Metorial gives your team governed access to Crisp, with tracing and security controls built in.