Chatwoot MCP. Manage support chats and contacts instantly.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Chatwoot MCP lets your AI agent manage all customer communications across every channel—Web, WhatsApp, Facebook, and more. It pulls conversation histories, tracks contacts, and sends replies directly from your chat interface without opening the dashboard.
If your job involves tracking who said what to whom across multiple support channels, this is it.
What your AI agents can do
Get chat history
Retrieves the full message thread for any specific customer support conversation.
Get contact details
Fetches detailed profile information and historical data for a particular customer contact.
Get conversation details
Gets overall metadata and status details for an entire conversation record.
Shows every communication channel (Web, WhatsApp, etc.) that is currently receiving customer messages.
Retrieves a specific customer's profile and full interaction history from your system.
Gives an overview of all active or past support chats in the entire account.
Pulls the full message thread for a specific conversation ID, providing complete context.
Sends a reply or status update directly to a customer within an active chat session.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Chatwoot MCP: 8 Tools for Communications
Use these tools to read contact data, list conversations across channels, retrieve message threads, or send replies directly through your AI client.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Chatwoot on Vinkius019d756dget chat history
Retrieves the full message thread for any specific customer support conversation.
019d756dget contact details
Fetches detailed profile information and historical data for a particular customer contact.
019d756dget conversation details
Gets overall metadata and status details for an entire conversation record.
019d756dlist chatwoot contacts
Provides a list of every contact record stored in your account.
019d756dlist chatwoot inboxes
Lists all configured communication channels, like Web widgets or WhatsApp accounts.
019d756dlist support agents
Gives a list of every support agent on the team and their current availability status.
019d756dlist woot conversations
Retrieves a summary list of all conversations that have taken place in your system.
019d756dsend chat message
Sends a direct message to a customer within a specific, ongoing chat session.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Chatwoot, then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Chatwoot. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 8 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
The Customer Support Dashboard is a Nightmare to Navigate
Today, if an agent needs context on a customer's issue, they have to do a lot of clicking. They jump from the main inbox to find the conversation ID, then click into the thread. If they need background info, they might have to open a separate contact profile tab just to see past purchases or names. It’s slow, tedious, and makes it easy for important context to get lost in the noise.
With this MCP, your agent handles the clicks behind the scenes. Instead of navigating tabs, you simply ask your AI client to pull the necessary data—whether that's through `list_woot_conversations` or by getting specific details via `get_contact_details`. You get a single, unified chunk of actionable information.
Send Chat Messages with Precision
The manual pain point here is the delay between deciding on an answer and actually sending it. An agent might draft a reply in their notes, wait for confirmation, then manually switch back to the chat window to paste and send it. This introduces friction and time loss.
Now, when your AI client calls `send_chat_message`, the response is immediate. The message goes straight from the intelligence layer into the correct channel—WhatsApp, Web widget, whatever—without any human intervention or context switching. It just works.
What you can do with this MCP connector
Chatwoot gives your AI agent full control over customer engagement. Instead of jumping into a separate helpdesk platform every time someone asks a question, your agent handles all chats—from WhatsApp messages to web widget queries—right where you're working. You can list and get details for any conversation or contact history immediately.
Need to reply? Your agent sends the message directly back to the customer in that active session. The system also lets you monitor every configured inbox, so nothing slips through the cracks. Because this MCP deals with high-volume, mission-critical communication data, all activity is visible via Vinkius AI Analytics. This means you can always see exactly what conversations were pulled and which tools executed, giving your team total visibility into customer interactions.
019d756d-ce3e-72c8-912d-87f7d8de8156 
How Chatwoot MCP Works
- 1 Subscribe to this MCP and provide your Chatwoot Access Token, Account ID, and Base URL.
- 2 Your AI client authenticates these credentials through the Vinkius zero-trust proxy for secure access.
- 3 You can then instruct your agent to perform actions like listing conversations or sending a reply.
The bottom line is you get immediate conversational control over customer service, without needing to log into the underlying chat dashboard.
Who Is Chatwoot MCP For?
Support Managers and Customer Success Leads. You're tired of having your agents click through five different tabs just to figure out who a customer is or what they were complaining about yesterday.
Monitors team performance by listing support agents and reviewing past chat histories using plain language prompts.
Engages with a customer—retrieving detailed contact information or sending follow-up messages—without ever leaving their main work interface.
Accesses the complete chat history and conversation details to understand complex user issues quickly during a live session.
What Changes When You Connect
- Stop copy-pasting. Need to know what the customer said last week? Use
get_chat_historyto pull the complete conversation log into your agent's context immediately. - No more guessing who you’re talking to. With
list_chatwoot_contacts, your agent can fetch comprehensive contact details, giving it all the necessary background before replying. - Handling multiple channels is easy. Use
list_chatwoot_inboxesto see every communication source—Web, Facebook, etc.—and know exactly where a customer message came from. -
send_chat_messagemeans you never have to switch tabs. Your agent can send a follow-up or confirmation directly into the live chat thread, closing the loop right away. - Need an overview of your team? Running
list_support_agentslets your agent check who's online and if a specific person is available for complex support tasks.
Real-World Use Cases
Investigating Customer Complaints
A customer complains about an old order. The user asks the agent to get the contact details, then list all conversations associated with that person, and finally retrieve the chat history for the specific thread to find out when the initial ticket was opened.
Following up after a Call
A sales rep finishes a call. They ask the agent to get the contact details of the prospect, pull the latest conversation details, and then send a follow-up message thanking them for their time.
Monitoring Team Coverage
The manager needs to know who is available right now. They prompt the agent to list support agents, check team capacity, and identify if any high-priority inboxes are unattended.
Cross-Channel Escalation
A customer messages via WhatsApp but has a complex issue. The user asks the agent to get conversation details from that channel and simultaneously pull up all related conversations across other channels for full context.
The Tradeoffs
Manually gathering history
The user has to jump into Chatwoot, find the customer's name, click the conversation ID, scroll up and down, and copy 10 messages just to give context to their AI agent.
→
Instead, instruct your agent to use get_chat_history. This pulls the entire message log automatically, feeding it directly into your prompt so you get instant context without manual work.
Assuming a single source of truth
Thinking that all customer data lives in one place and only needs one API call to pull everything.
→
The system requires multiple calls. To build full context, chain list_chatwoot_contacts with get_conversation_details, then use the resulting ID for get_chat_history.
Forgetting who you're talking to
Replying to a chat message but having no idea if that customer is actually a new lead or an established client.
→
Always start by using get_contact_details. This provides the full profile, ensuring your reply is tailored and accurate.
When It Fits, When It Doesn't
Use this MCP when your primary need is real-time communication management: tracking conversations or sending replies. You should use it if you need to combine data—for example, getting contact details and then listing the conversation history for that specific person. Don't use this if you just need a simple list of names; stick to list_chatwoot_contacts. More importantly, don't use this MCP if your process requires internal workflow approval or complex task scheduling across multiple non-messaging systems (like billing). For those scenarios, you should build out multi-MCP chains using the Vinkius platform itself.
Common Questions About Chatwoot MCP
How do I list all conversations using get_woot_conversations? +
You tell the agent to run list_woot_conversations. This gives you a summary of every conversation in the account, allowing you to identify which specific thread needs deeper context.
Can I send messages using send_chat_message? +
Yes. You instruct your agent to use send_chat_message and specify the target conversation ID and the message content. The reply goes straight to the customer through their active channel.
What is the best way to check a customer's history? list_chatwoot_contacts or get_contact_details? +
list_chatwoot_contacts gives you a simple roster of all available contacts. If you already know the person, use get_contact_details for their full profile and deep historical record.
Do I need to list_support_agents before using this MCP? +
No. You can run list_support_agents anytime you want a roster of team members, but it doesn't restrict your ability to read conversation history or send messages.
What does the tool `list_chatwoot_inboxes` show me? +
It lists every communication channel—like Web widgets, WhatsApp, or Facebook Messenger—that's connected to your Chatwoot account. This is useful for confirming all available entry points before you start retrieving conversation data.
Should I use `list_chatwoot_contacts` or `get_contact_details` when checking on a customer? +
Use get_contact_details to get deep, specific information about one person. If you just need an overview of all stored profiles across your system, then running list_chatwoot_contacts is better.
When I use `get_chat_history`, what kind of messages does it retrieve? +
It pulls the full message content for a specific conversation ID. You'll see every message sent, who sent it, and the exact timestamp, giving you a complete timeline of interaction.
How is `get_conversation_details` different from just listing conversations? +
This tool gives you rich metadata about the conversation itself. You'll get details like which channel was used and if the chat has been marked as resolved or still active, adding context beyond just the ID.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.