# Hiver MCP MCP > Hiver. Turn shared Gmail inboxes into an intelligent helpdesk right inside your existing email flow. This MCP lets your agent read conversations, update statuses (open, closed), tag threads, and even draft replies for the whole team—all without you ever leaving your inbox. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** shared-inbox, gmail-integration, email-management, sla-tracking, customer-service, team-collaboration ## Description Managing a high-volume support desk means constant context switching. Your agents can now treat shared Gmail inboxes like dedicated helpdesks. Instead of jumping between multiple tools just to figure out who replied or what status an issue is in, your agent handles the whole workflow conversationally. It retrieves full details on any email thread and lets you assign ownership or change the status—all from a single chat interface. This dramatically cuts down on manual overhead. When connected via Vinkius, this MCP gives your AI client visibility into everything: which shared inboxes exist, who's available on the team roster, and what tags are applied to threads. You can programmatically update statuses or create drafted replies directly inside Gmail, making sure every conversation is tracked and handled correctly. ## Tools ### create_shared_draft Generates a draft reply that multiple team members can review before sending it out of Gmail. ### get_api_status Confirms the connection and operational status between your agent and Hiver's system. ### get_conversation_details Retrieves all the historical information for a specific email conversation thread. ### get_inbox_details Fetches general metadata and configuration details about a particular shared mailbox. ### list_inbox_conversations Pulls a list of all active, ongoing threads from specified shared inboxes. ### list_shared_inboxes Identifies and lists every shared inbox connected to your Hiver account. ### list_inbox_tags Lists all available categorization tags for the mailbox so you know what to search or apply. ### list_inbox_members Provides a roster of all team members associated with the inbox and checks their availability. ### search_tags_by_name Searches the system for specific tags by their name or criteria. ### search_team_members Locates and verifies team members based on names or roles within the organization. ### test_hiver_auth Runs a simple test to verify that your provided credentials are valid for API access. ### update_thread_status Changes the official status of an email thread, marking it as open, pending, or closed. ## Prompt Examples **Prompt:** ``` List all shared inboxes in my Hiver account. ``` **Response:** ``` I've fetched your inboxes. You have access to: 'Support' (ID: inbox_1), 'Sales' (ID: inbox_2), and 'Operations' (ID: inbox_3). Which one should we check for new messages? ``` **Prompt:** ``` Show me the last 5 open conversations in the 'Support' inbox. ``` **Response:** ``` Scanning 'Support'... I found 5 active threads. The most urgent one is 'Issue with login' from 'user@example.com'. Would you like to see the full details or assign it to someone? ``` **Prompt:** ``` Assign conversation 'thread-123' to user 'user-456' and add the tag 'priority'. ``` **Response:** ``` Done! Conversation 'thread-123' has been assigned to user 'user-456' and tagged as 'priority'. Your team will see the updated status in Hiver immediately. ``` ## Capabilities ### View Inbox Status List all shared inboxes and retrieve detailed metadata for active email conversations. ### Change Thread Ownership and State Update conversation statuses (like open or closed) and assign ownership across your team members programmatically. ### Draft Team Replies Create shared drafts directly within Gmail threads so the whole team can review and perfect a response before sending it out. ### Organize Threads with Tags Search for, apply, and retrieve specific tags to categorize email threads and manage high-fidelity collaboration records. ### Manage Team Roster List all members in the inbox and search for team availability to ensure workload distribution. ## Use Cases ### Triage a sudden spike in tickets A new issue hits, and you need to know how many threads are open. You ask your agent to run `list_inbox_conversations` on the main support inbox. The agent reports back not only the count but also flags which conversations haven't been touched in 24 hours. ### Hand off a complex account issue A technical thread needs to move from Level 1 Support to Engineering. You run `list_inbox_members` and identify the right engineer, then use your agent to assign the ticket using `update_thread_status`, ensuring they get an instant notification. ### Finalize a joint client response Multiple people contributed ideas for a client reply. Instead of copying all notes into one email, you ask your agent to use the `create_shared_draft` tool, allowing everyone to edit and polish the message before sending. ### Audit old tickets You need to check every thread related to a specific product bug. You first run `search_tags_by_name` for 'Bug-Alpha' and then use the resulting list of threads with `get_conversation_details` to pull all relevant historical data. ## Benefits - Instant status updates: Instead of opening threads manually, you can use the `list_inbox_conversations` tool to get an immediate overview of all open tickets and their current state. - Zero context switching: You don't need to leave your inbox. The ability to `create_shared_draft` means you draft a complex reply using your agent, then just hit send in Gmail. - Team accountability: When things get messy, the MCP lets you use `list_inbox_members` and `search_team_members` to see who is available and assign ownership instantly. - Structured organization: Use tags to keep data clean. The tools let you list all available tags (`list_inbox_tags`) or search for them, ensuring every ticket gets proper categorization. - Automated workflow control: You can use `update_thread_status` to automatically move a conversation from 'Pending Review' to 'Closed' the moment it meets certain criteria. ## How It Works The bottom line is you get a single conversational point of entry to manage complex, multi-step support operations inside Gmail. 1. Subscribe to this MCP and grab your API key from the Hiver Admin Panel (Integrations > Developer APIs). 2. Connect your AI client using that key. Your agent now sees the full scope of shared inboxes available. 3. You talk to your agent: 'List all open threads for the Support inbox.' The agent reads and processes the data, providing you with actionable insights. ## Frequently Asked Questions **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. **When should I run the `get_api_status` tool to verify my Hiver API key setup?** You run this immediately after connecting your account. It confirms that your credentials are valid and active against the Hiver platform. This step is necessary before running any state-changing actions. **What information does `get_conversation_details` provide about an email thread?** It returns all metadata and historical content for a specific conversation. You get the full context needed to understand replies, assignments, and changes over time in one place. **Can I use the `update_thread_status` tool to modify an email's lifecycle stage?** Yes, you can programmatically set a thread as open, pending, or closed. This keeps your team's workflow visible and accurate inside Hiver without needing manual updates. **What does running `list_inbox_tags` tell me about my shared inboxes?** It retrieves the current set of labels and categories applied to a specific mailbox. This lets your agent read the existing organizational structure before you tag or search for content. **What should I expect when using the `list_shared_inboxes` tool initially?** The tool returns a list of all connected Hiver inboxes and their unique IDs. If no shared mailboxes are found, it simply means no operational shared hubs are configured for your account.