# Hiver MCP for AI Agents AI Agent Connect

> Hiver MCP turns your Gmail into a shared team helpdesk. It lets your AI agent handle ticket assignments, update statuses, and draft replies directly in your support threads. Stop jumping between tabs to see who is working on what.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_HjnqBSc6xleqESDmh1tB3Ojp76QnCGTazNLfBLMS/ai-agent-connect
- **Tags:** shared-inbox, gmail-integration, email-management, sla-tracking, customer-service, team-collaboration

## Description

Hiver is an Connector that turns a standard Gmail inbox into a structured, team-oriented helpdesk. Instead of everyone digging through the same pile of emails to see what needs to be done, your agent can act as a central coordinator. It can look across all your shared mailboxes, identify which conversations are still open, and tell you exactly what needs attention. If you have a high volume of incoming requests, you can ask your agent to find specific threads based on tags or search for certain keywords. It handles the busy work of moving things along, like updating a conversation status from pending to closed or assigning a new ticket to the right person on your team. 

You can also have your agent do the first pass on complex replies. By creating a shared draft directly in a Gmail thread, your agent gives your team a starting point that anyone can review and edit. This keeps everyone on the same page and ensures a consistent voice for your customers. It is a practical way to manage a high-volume support hub without the constant back-and-forth of manual updates. You will find this in the Vinkius catalog as a way to manage your operations without the friction of jumping between tabs and manual data entry. It lets your team focus on actually solving customer problems rather than just sorting through their emails.

## Tools

### get_api_status
Check if your connection to Hiver is active. This helps you confirm the link is working before you start tasks.

### get_conversation_details
Read the full content of a specific email thread. This lets your agent see the whole history of a customer's issue.

### get_inbox_details
Get the specific configuration and metadata for a mailbox. Use this to understand the scope of a shared inbox.

### list_inbox_conversations
See a list of all active threads in a shared inbox. This is the primary way to see what needs attention.

### list_shared_inboxes
View all the different mailboxes you have set up. Use this to switch between support, sales, or other categories.

### list_inbox_tags
See all the labels currently used to organize your threads. This helps your agent understand your filing system.

### list_inbox_members
See who's on your team and who has access to the inbox. Use this to find out who is currently available.

### search_tags_by_name
Find specific labels to help filter your conversations. This allows for quick filtering of specific issues like billing.

### search_team_members
Look up specific team members to check their info. Use this to find the right contact for a specific task.

### test_hiver_auth
Verify that your API credentials are working correctly. Run this to make sure your agent has the right permissions.

### update_thread_status
Change a conversation's status to open, pending, or closed. Use this to keep the team updated on progress.

### create_shared_draft
Generate a reply draft that the whole team can see and edit. This lets your agent do the heavy lifting on writing.

## Prompt Examples

**Prompt:** 
```
Show me all the open conversations in the 'Support' inbox.
```

**Response:** 
```
I've scanned your 'Support' inbox and found the following active threads:

| Thread Subject | Priority | Assigned To |
| :--- | :--- | :--- |
| **Login Issue** | High | Unassigned |
| **Billing Inquiry** | Medium | Sarah |
| **Feature Request** | Low | Open |

Would you like me to assign the login issue to someone?
```

**Prompt:** 
```
Assign the thread about the login issue to Sarah and mark it as pending.
```

**Response:** 
```
Done! I've updated the conversation regarding the login issue. 

*   **Status**: Pending
*   **Assigned To**: Sarah

Your team will see these updates in Hiver immediately.
```

**Prompt:** 
```
Create a draft for the customer who wants a refund, then tell me what it says.
```

**Response:** 
```
I've created a shared draft for the refund request. Here is the text:

*"Hello, thank you for reaching out. We have received your request for a refund. Our team is currently reviewing your account history and will get back to you within 24 hours with a final decision."*

You can now find this draft in your Gmail thread to review or send.
```

## Capabilities

### List all shared mailboxes
See all the different Hiver inboxes you have set up in one place.

### Read email thread details
Get the full history and metadata for a specific conversation.

### Update conversation statuses
Change a thread from open to pending or closed to keep the team synced.

### Create shared drafts
Have your agent write a first draft that your whole team can see and edit.

### Search and apply tags
Categorize threads quickly using existing labels or find specific ones by name.

### List team members
Check who is on your team and who has access to specific mailboxes.

## Use Cases

### High-volume triage
A support lead asks the agent to find all open threads in the Sales inbox and list them to identify where to start the day.

### Team handoff
An agent takes a complex issue and uses update_thread_status to move it to pending while tagging it for a senior lead.

### Draft generation
A success lead asks the agent to draft a response to a frustrated user and save it as a shared draft for review.

### Workload check
An ops manager asks the agent to list all active threads to see if the team is currently overwhelmed by volume.

## Benefits

- Stop manual triaging by using list_inbox_conversations to find urgent threads instantly.
- Keep the team synced by using update_thread_status to show everyone the current progress.
- Save time on complex replies with create_shared_draft so your agent can do the first pass.
- Organize your workflow better by searching for and applying tags with search_tags_by_name.
- Reduce duplicate work by checking list_inbox_members to see who's already handling a request.

## How It Works

The bottom line is you get a dedicated inbox coordinator that handles the grunt work of support management.

1. Subscribe to the Hiver MCP on Vinkius.
2. Grab your API Key from the Hiver Admin Panel under Integrations.
3. Link your keys to your AI client to start managing your support hub.

## Frequently Asked Questions

**Can the Hiver MCP help my team manage a shared Gmail inbox?**
Yes, it allows your AI agent to see, organize, and manage shared mailboxes, making it much easier for a team to collaborate on the same set of emails.

**How does the Hiver MCP handle ticket assignments?**
Your agent can identify who is available and assign specific threads to team members, ensuring that every customer request has an owner.

**Can I use the Hiver MCP to create drafts for my team to review?**
Yes, your agent can write the first draft of a reply and save it as a shared draft. This allows your team to quickly review and send the response.

**Does the Hiver MCP support updating conversation statuses?**
It does. Your agent can move threads between statuses like open, pending, and closed, which keeps your team updated on the progress of every ticket.

**Can the Hiver MCP list all my shared mailboxes at once?**
Yes, it can pull a full list of your shared inboxes so your agent can help you navigate between different departments like sales or support.

**Is the Hiver MCP good for customer support teams?**
It is specifically designed for support teams who need to manage high volumes of email without the chaos of a standard personal inbox.

**Can I use the Hiver MCP to find specific tags in my Hiver inbox?**
Yes, your agent can search for specific labels or tags to help you filter conversations by priority, category, or urgency.

**How do I find an inbox ID?**
Use the `list_shared_inboxes` tool to retrieve all shared mailboxes you have access to, along with their unique identifiers and names.

**Can I assign a conversation to a specific teammate?**
Yes! Use the `update_thread_status` tool and provide the `assignee_id`. You can find valid user IDs using the `list_inbox_members` tool.

**Does Hiver support collaborative drafting through AI?**
Yes, the `create_shared_draft` tool allows your AI agent to write directly into a Gmail thread, which your team can then review and send from the Hiver interface.