# Chatwoot MCP for AI Agents AI Agent Connect

> Chatwoot MCP lets you manage customer support conversations directly from your AI agent. You can send replies, track active chats, and look up customer history across channels like WhatsApp, Facebook, and web widgets without switching tabs. It connects your helpdesk to your workflow so you can handle tickets faster.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_6yC9zEQQG98tfpmJkktR9vNq1xofu8MAvZfxmH2D/ai-agent-connect
- **Tags:** omnichannel, helpdesk, customer-engagement, conversational-ai, ticket-management

## Description

Managing customer support usually means jumping between browser tabs, copying details from one window to another, and trying to remember what a customer said three days ago. This Connector changes that by bringing your Chatwoot helpdesk inbox into your AI agent's workspace. Instead of hunting for information, you can just ask your agent to find a specific contact or see the latest messages from a specific channel. You can send replies to customers on WhatsApp or Facebook without leaving your primary interface. It handles the heavy lifting of navigating the dashboard so you can focus on actually solving problems. If you're looking for a way to keep your customer engagement consistent, this is part of the Vinkius catalog and makes it easy to keep your support team organized. You get a clear view of your team's availability and the full history of every interaction in one place. You can see who is currently online and ready to take new chats, ensuring that no customer is left waiting. This setup removes the friction of manual data entry and keeps your support flow moving without the usual interruptions of switching between different communication apps. By centralizing your customer data, you can provide faster, more accurate answers that build trust with your users every time they reach out. You can also quickly see which inboxes are getting the most traffic, allowing you to adjust your staffing levels as needed. It's about moving away from reactive firefighting and toward a more proactive way of handling your customer needs.

## Tools

### list_support_agents
Shows a list of all agents on your team. This helps you see who is online and ready to take chats.

### list_chatwoot_contacts
Lists every customer in your database. You can use this to find specific people to follow up with.

### get_contact_details
Pulls up the full profile and history for a specific customer. This helps you see past issues before you reply.

### get_conversation_details
Fetches the specific metadata for a chat session. You can use this to see which channel a customer is using.

### list_woot_conversations
Shows all conversations in your account. It lets you quickly see which chats need attention right now.

### list_chatwoot_inboxes
Lists all your active channels like WhatsApp and Web widgets. You can see where your traffic is coming from.

### get_chat_history
Retrieves every message sent in a specific conversation. Use this to get the full context of a long chat.

### send_chat_message
Sends a direct reply to a customer in a specific chat. This is how you actually communicate with your users.

## Prompt Examples

**Prompt:** 
```
Who is currently online to help with new chats?
```

**Response:** 
```
Here are the agents currently available on your team:

| Agent Name | Status |
| :--- | :--- |
| Sarah Miller | Online |
| James Chen | Away |
| Maria Garcia | Online |

Sarah and Maria are ready to take new messages.
```

**Prompt:** 
```
What's the history for conversation 1234?
```

**Response:** 
```
I've pulled the history for conversation 1234. Here's what's been happening:

* **Customer:** 'I haven't received my shipping update yet.'
* **Agent:** 'Let me check that for you.'
* **Customer:** 'Thanks, I'm just worried because it's been three days.'

It looks like the customer is anxious about a delivery delay.
```

**Prompt:** 
```
Send a reply to the WhatsApp chat from Sarah Smith saying we're looking into it.
```

**Response:** 
```
I'm sending that reply to Sarah Smith via WhatsApp now. I'll let you know as soon as it's delivered.
```

## Capabilities

### Send messages to customers
Reply to active chats on any connected channel instantly.

### Fetch conversation history
Get the full context of past interactions to understand customer needs.

### Look up contact info
Pull up detailed customer profiles and history for specific individuals.

### Monitor active inboxes
See which channels like Web or WhatsApp have pending messages.

### Track support agents
View the status and availability of your team members in real-time.

### List all conversations
Browse through every active and resolved chat in your account.

## Use Cases

### Checking past customer history
A support lead needs to see if a specific customer has had issues before. They ask the agent to find the contact and read the history.

### Replying to social media messages
A small business owner gets a WhatsApp message and wants to reply. They tell the agent to send a 'Thank you' message to that specific conversation.

### Monitoring high-traffic channels
A customer success rep wants to see which inboxes are the busiest. They ask the agent to list all active inboxes.

### Tracking active support volume
A manager needs to know how many active chats are happening. They ask the agent to list all conversations.

## Benefits

- Stop switching tabs between WhatsApp and Facebook because you can handle all channels in one place using list_chatwoot_inboxes.
- Get full context on customer issues instantly by pulling up the entire message thread with get_chat_history.
- Reduce response times by sending direct replies to customers on any platform using the send_chat_message tool.
- Keep your team organized by checking who is available to help right now with list_support_agents.
- Improve customer experience by quickly finding past interactions using get_contact_details to provide personalized help.

## How It Works

The bottom line is you get a unified way to handle omnichannel support without leaving your AI tool.

1. Get your Chatwoot Access Token, Account ID, and Base URL.
2. Plug those details into your Connector configuration.
3. Start asking your AI agent to manage your support tickets.

## Frequently Asked Questions

**Can I use Chatwoot MCP to reply to customers on WhatsApp?**
Yes, this Connector lets your AI agent send messages directly to customers on WhatsApp, Facebook, and other integrated channels.

**How does Chatwoot MCP help with customer history?**
It allows your agent to pull up the full history of past interactions for any specific customer, so you have all the context you need before replying.

**Can I see which support agents are online using Chatwoot MCP?**
Yes, you can ask your agent to list all support agents and see their real-time availability status.

**Does Chatwoot MCP work with my web widget?**
It does. You can use it to monitor and manage messages coming in from your web widgets as well as social media channels.

**How many conversations can I see with Chatwoot MCP?**
You can list and retrieve details for all active and resolved conversations in your account to keep your workspace organized.

**Is Chatwoot MCP good for small businesses?**
It's great for small businesses that need to manage multiple customer channels without hiring a large team to monitor every app.

**Can I reply to a WhatsApp message through the agent?**
Yes! Use the `send_chat_message` tool with the conversation ID. As long as your WhatsApp inbox is connected to Chatwoot, the agent will deliver your reply.

**How do I see the full history of a chat?**
Use the `get_chat_history` tool with the unique conversation ID. Your agent will fetch all previous messages, allowing you to review the entire interaction.

**Where do I find my Chatwoot Access Token?**
Log in to Chatwoot, click on your profile avatar in the bottom left, and select 'Profile Settings'. Scroll to the bottom to find your personal 'Access Token'.