How to Use the Chatwoot MCP in Windsurf

Q: How do I install the Chatwoot MCP server in Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server block under the mcpServers key. You can also use the built-in MCP Marketplace for a one-click setup. Click refresh in the MCP panel when you finish.

Q: How do I find specific WhatsApp conversations?

Ask your agent to filter the queues. It runs listchatwootinboxes to find the WhatsApp channel ID, then pulls the active chats.

Let Windsurf's Cascade agent handle customer support tickets autonomously by pulling user context and sending replies.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Chatwoot MCP to Windsurf

Create your Vinkius account to connect Chatwoot to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Chatwoot with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Triage inboxes with this MCP Server

Cascade doesn't wait around for you to feed it context. When a new ticket hits your desk, your agent uses `list_chatwoot_inboxes` to scan WhatsApp and Web channels instantly. It grabs the active queues and flags what needs attention. You just tell Windsurf to clear the backlog. The agent loops through `list_woot_conversations` and builds a priority list without asking for permission. You watch the terminal output while it figures out exactly who needs a response first.

Dig up deep customer context

Writing a blind reply usually backfires. Before drafting a response, your agent automatically fires `get_contact_details` to pull the user's history and account status. It knows exactly who it is talking to. From there, Cascade runs `get_chat_history` to read the last five things your support team told them. It pieces together the entire timeline so the final message actually makes sense.

Draft and push replies instantly

You don't need to switch tabs to close out a ticket. Once the agent understands the problem, it triggers `send_chat_message` to push the text directly to the customer. If a ticket needs human review, Windsurf assigns it by pulling the roster with `list_support_agents`. The whole loop happens right inside your editor while you focus on writing actual code.

Setup guide

Set up Chatwoot MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Chatwoot MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Chatwoot payment history." If connected, Cascade will call the Chatwoot tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "chatwoot-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Chatwoot now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Chatwoot MCP in Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server block under the `mcpServers` key. You can also use the built-in MCP Marketplace for a one-click setup. Click refresh in the MCP panel when you finish.

Yes. When you ask Windsurf about a specific user, Cascade chains `get_contact_details` and `get_chat_history` on its own. It reads the previous messages to figure out the context before suggesting a fix.

You just tell Cascade what you want to say. The agent formats the payload and executes `send_chat_message` to push your response to the live conversation.

Ask your agent to filter the queues. It runs `list_chatwoot_inboxes` to find the WhatsApp channel ID, then pulls the active chats.

Vinkius isolates your connection inside a V8 sandbox. When Windsurf pulls sensitive names or message histories, the data stays ephemeral. The connection drops the moment your session ends.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript