# Chatwoot MCP for AI Agents MCP

> Chatwoot lets your AI agent manage customer communications across every channel. Instead of jumping between social media dashboards, you get a single view to track conversations, review entire message histories, and reply instantly whether the customer messaged via WhatsApp, web widget, or Facebook. It's full control over your support pipeline directly from any AI client.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** omnichannel, helpdesk, customer-engagement, conversational-ai, ticket-management

## Description

Your agent connects with Chatwoot so it can take full control of your customer service communications through natural conversation. You don't have to open a dozen different dashboards just to keep up with the flow of tickets; this MCP centralizes everything—from Web widget chats to WhatsApp messages and social media inquiries. It gives you visibility into every single interaction, allowing your agent to track which conversations are active or resolved, and even monitor all configured inboxes. Need context? Your agent can pull complete message histories for any customer conversation. You can also get details on specific contacts or check team availability by listing support agents. When using this MCP through Vinkius, you simply subscribe, enter your Chatwoot credentials, and start managing the entire support lifecycle without ever leaving your AI client.

## Tools

### get_contact_details
Retrieves detailed information about one specific customer contact.

### get_conversation_details
Fetches specific metadata for a single chat conversation instance.

### list_support_agents
Lists all support staff members and checks their current availability status.

### list_chatwoot_contacts
Retrieves a complete list of every customer contact record in the system.

### list_woot_conversations
Gets an overview and list of all conversations currently housed in your account.

### list_chatwoot_inboxes
Lists every communication channel inbox configured, like Web or WhatsApp.

### get_chat_history
Pulls the complete message thread for a given conversation ID so you know what was discussed.

### send_chat_message
Sends an immediate reply to a customer within an ongoing chat session.

## Prompt Examples

**Prompt:** 
```
What's the full chat history for John Doe who messaged from WhatsApp last week?
```

**Response:** 
```
**Conversation Summary: ID 9012**
*   **Date:** Oct 24, 2026
*   **Channels Involved:** WhatsApp, Web Widget
*   **Key Issues:** Initial query about shipping delays. Followed up with a request for tracking number validation.
*   **Last Message (Agent):** 'We see the delay; we've applied a 15% discount on your next order.' 

***Action needed: Send a follow-up message confirming the coupon code delivery.**
```

**Prompt:** 
```
Can you list all active chats and tell me who I should talk to first?
```

**Response:** 
```
**Active Conversations Report**
| Chat ID | Customer Name | Channel | Status |
| :---: | :---: | :---: | :---: |
| 1023 | Sarah Smith | WhatsApp | Open (Urgent) |
| 1024 | Mike Miller | Web Widget | Open (Info) |
| 1025 | Jane Doe | Facebook | Resolved |

*Recommendation: Start with Sarah Smith; the conversation has been open for 3 hours without a reply.*
```

**Prompt:** 
```
I need to send a quick apology message to John Doe in chat ID 9012.
```

**Response:** 
```
**Message Sent Successfully**
*   **Recipient:** John Doe
*   **Channel:** WhatsApp
*   **Content:** 'Apologies for the delay! We've manually processed your refund and it should show up within 3-5 business days.'
*   **Status:** Delivered to customer.
```

## Capabilities

### List all customer contacts
Fetch a list of every contact in the account to understand who needs help.

### Get specific contact information
Retrieve detailed profile data for a single customer, including their full history with you.

### List all active and resolved conversations
Pull a comprehensive list of every ongoing or closed support conversation.

### Get detailed conversation context
Retrieve specific information about a single chat session, like the associated channels or last activity date.

### List all communication inboxes
See which customer service channels are connected and actively receiving messages (e.g., Web, WhatsApp).

### Retrieve full message history
Access the entire transcript of a conversation to understand the full context before replying.

### Send immediate replies
Draft and send messages directly into an active customer chat, regardless of how it started.

## Use Cases

### A new user asks about a refund status
Problem: A customer messaged via WhatsApp but the agent doesn't know their history. Solution: The user asks the agent to check `get_chat_history` and `get_contact_details`. The agent provides all previous interactions, allowing a quick, informed reply.

### The team needs an operational overview
Problem: A support manager needs to know if the web widget is receiving messages or if another channel is quiet. Solution: The user asks the agent to run `list_chatwoot_inboxes`. The agent immediately reports which channels are active, guiding resource allocation.

### Quickly responding to a client complaint
Problem: A customer complains via Facebook and needs immediate help. Solution: The user asks the agent to `send_chat_message`. The agent drafts and sends a professional acknowledgment instantly, without manual intervention.

### Onboarding a new representative
Problem: A manager needs to train staff on who is available. Solution: The user asks the agent to `list_support_agents`. The agent provides an up-to-date roster of all team members and their current status.

## Benefits

- Instead of manually switching between WhatsApp, Facebook, and web widgets, your agent handles all channels through one conversation view. This saves time and prevents context loss.
- Use the `get_chat_history` tool to instantly pull a full transcript for any chat, so your agent never replies without full customer context.
- The ability to run `list_support_agents` means you can monitor team availability in real-time, helping managers route tickets efficiently.
- You don't need to open the main dashboard; using tools like `get_contact_details` lets your agent pull critical customer profile information on demand.
- The `send_chat_message` tool allows for immediate replies across all channels, speeding up resolution time and keeping customers happy.

## How It Works

The bottom line is that you plug in your credentials once and immediately gain full command over every customer interaction across all channels.

1. First, subscribe to this MCP and provide your Chatwoot Access Token, Account ID, and Base URL.
2. Next, connect the MCP to any compatible AI client like Claude or Cursor. This gives your agent access to all support tools.
3. Finally, ask your agent to perform a task—for example, 'List all open chats from WhatsApp'—and it handles the rest.

## Frequently Asked Questions

**How does Chatwoot MCP help me manage multiple support channels?**
It centralizes everything. Instead of logging into separate apps for WhatsApp, Facebook, and your web widget, your agent sees all incoming messages in one place. You can reply to any channel without switching dashboards.

**Can I use Chatwoot MCP if my customers only message me via email?**
This particular MCP is built for chat and social channels (WhatsApp, Web, etc.). If your primary communication method is email, you might need a dedicated email integration tool instead.

**What kind of information can I get about a customer using Chatwoot MCP?**
You can pull comprehensive data. This includes their full contact profile details and the complete transcript (chat history) from every single time they've talked to you.

**Does Chatwoot MCP help me with my support team scheduling?**
Yes, it lets your agent list all available support agents. This is helpful for managers who need to know who is online and ready to handle a new ticket right now.

**Is Chatwoot MCP just for reading messages or can I reply?**
You can do both. You can read the full history using `get_chat_history` and, crucially, you can use your agent to send replies directly into active chats.