# Helpwise MCP

> Helpwise connects your AI agent directly to shared customer inboxes for email, SMS, and WhatsApp support. It lets you manage full conversations, track contacts, and send replies across multiple channels without leaving your client environment.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** shared-inbox, email-management, sms-support, whatsapp-integration, team-collaboration, customer-service

## Description

Managing modern customer service means handling communications everywhere: email, text messages, WhatsApp, and social media. This MCP gives your AI agent a unified view of all those shared inboxes. You stop jumping between dashboards to figure out who needs help or what the last message was. Your agent can list every connected mailbox, browse conversations across all channels, and even pull up full contact profiles before you write a single word. When a customer sends an SMS complaint, your AI client instantly sees it alongside their past emails. You don't have to switch accounts; you just talk to the MCP. This deep integration lets you handle everything from listing team members to sending outgoing replies—all within your preferred AI environment. If you’re looking for robust communication tools that connect across platforms, check out the full catalog of integrations available on Vinkius.

## Tools

### create_contact
Creates and saves a brand-new contact profile within the Helpwise system.

### get_conversation_details
Retrieves the full message history and context for one specific customer conversation thread.

### list_contacts
Pulls a list of existing contacts stored in the Helpwise database.

### list_conversations
Lists all active conversations within a specific shared mailbox.

### list_mailboxes
Provides an overview of every connected, shared support inbox (email, SMS, WhatsApp).

### list_team_members
Retrieves a list of all agents and team users linked to the account.

### send_email
Sends an outgoing email or reply message using one of the connected shared mailboxes.

## Prompt Examples

**Prompt:** 
```
Show all shared mailboxes and the latest conversations in the support inbox.
```

**Response:** 
```
You have 4 shared mailboxes: 1) 'Support' (mailbox_1, email, 12 open conversations). 2) 'Sales' (mailbox_2, email, 5 open). 3) 'WhatsApp Business' (mailbox_3, WhatsApp, 8 open). 4) 'Info' (mailbox_4, email, 3 open). Latest conversations in 'Support': 1) 'Billing issue — double charge' from john@example.com (2 hours ago, 4 messages). 2) 'API integration help' from dev@techco.com (3 hours ago, 6 messages). 3) 'Password reset request' from sarah@company.com (5 hours ago, 2 messages). Would you like to read a specific conversation or send a reply?
```

**Prompt:** 
```
Create a new contact for 'Maria Silva' and send her a welcome email from the support mailbox.
```

**Response:** 
```
Contact created! Name: Maria Silva, Email: maria@example.com, ID: contact_4521. Now sending welcome email via 'Support' mailbox (mailbox_1)... ✅ Email sent! To: maria@example.com, Subject: 'Welcome to Our Support', Body: Professional welcome message with onboarding links. The conversation will appear in the Support inbox once Maria replies. Would you like to list all contacts or send another email?
```

**Prompt:** 
```
List all team members and show the full thread for the billing conversation.
```

**Response:** 
```
Team members: 6 agents. 1) Sarah Chen (Admin, online). 2) Mike Torres (Agent, online). 3) Lisa Park (Agent, away). 4) James Rodriguez (Agent, offline). 5) Ana Müller (Agent, online). 6) Bot Agent (Automation). Billing conversation thread (conv_8901, 4 messages): [Customer 2h ago]: 'I was charged twice for my subscription. Order #12345.' [Mike 1h30m ago]: 'I apologize for the inconvenience. Let me check your account.' [Customer 1h ago]: 'Please fix this ASAP, I need the refund.' [Mike 45m ago]: 'I've initiated a refund for the duplicate charge. You should see it within 3-5 business days.' Status: Awaiting customer confirmation. Would you like to send a follow-up or close this conversation?
```

## Capabilities

### View all shared inboxes
List and get the status of every connected mailbox (email, SMS, WhatsApp) so you know where to look for messages.

### Track full message history
Browse specific conversations across any channel, showing the complete thread and who said what.

### Create new customer profiles
Build a clean contact record instantly using a customer's name or email address.

### Send replies through channels
Draft and send outgoing emails or messages directly from the shared inbox via your AI client.

### Manage team roster
Retrieve a list of all agents and team members linked to the account for context.

## Use Cases

### Handling a multi-channel complaint
A customer first emails about an issue, then texts follow-up questions. Your agent uses `list_mailboxes` to confirm the email channel and `get_conversation_details` to pull up the full thread, allowing it to draft a single, comprehensive reply that addresses both channels.

### Onboarding a new lead
A sales prospect sends an initial message via WhatsApp. Your agent uses `list_mailboxes` to identify the channel and then executes `create_contact`, immediately building a clean profile before sending a personalized follow-up.

### Team handoff and coverage check
A team lead needs to know who is on call. The agent uses `list_team_members` to get the roster, then uses `list_conversations` to audit open tickets that need attention from a specific colleague.

### Closing the loop after an issue
After investigating an account problem, your agent uses `get_conversation_details` on the support thread. Once resolved, it sends the final status update using `send_email`, closing out the ticket cleanly.

## Benefits

- Keep context unified. When a customer reaches out via SMS, your agent can immediately see their previous email thread and WhatsApp history using the `get_conversation_details` tool.
- Save time on data entry. Instead of manually creating accounts, use `create_contact` to instantly build clean profiles for new leads or returning customers.
- Total visibility over channels. The `list_mailboxes` tool lets you see if your support team is receiving messages through email, SMS, or WhatsApp—all in one prompt.
- Respond without switching apps. You can draft and dispatch replies using the `send_email` tool, making sure the communication comes out of the correct shared mailbox.
- Better team oversight. Use `list_team_members` to see who is available for support right now, helping you route tickets faster.

## How It Works

The bottom line is that you get cross-channel visibility into customer communications managed entirely through conversational prompts.

1. First, subscribe to this MCP and input your unique Helpwise API Key and Secret into your client's settings.
2. Next, use a natural language prompt in your AI client—for instance, asking it to list all shared mailboxes or track a specific conversation ID.
3. The agent executes the required actions against the Helpwise platform and returns structured data, allowing you to continue managing support without leaving your workflow.

## Frequently Asked Questions

**How does Helpwise MCP handle different communication types?**
Helpwise manages multiple channels by listing them all in the shared inboxes, including email, SMS, and WhatsApp. You can ask your agent to list all connected mailboxes to see what's active.

**Can Helpwise MCP automatically update contact records?**
Yes. While you have to use the `create_contact` tool manually, it allows you to build new customer profiles instantly with details pulled from conversations.

**Does this MCP only work for emails?**
No. It is designed for shared inboxes that pull data from multiple sources like SMS and WhatsApp, giving you a holistic view of all customer interactions.

**How do I see the full context of an old conversation using Helpwise MCP?**
You use the `get_conversation_details` tool. This pulls every message in the thread, showing who sent it and when, regardless of whether it was a text or an email.

**Can I send replies from multiple channels using Helpwise MCP?**
Yes. You use the `send_email` tool to dispatch messages through any connected shared mailbox, ensuring consistency across your support methods.