# groove-hq MCP server

Read Groove shared-inbox conversations, contacts, agents and tags; close, assign, snooze and tag.

## Links
- Registry page: https://www.getdrio.com/mcp/io-usefulapi-groove-hq
- Repository: https://github.com/m190/usefulapi-mcp

## Install
- Endpoint: https://groove-hq.usefulapi.io/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://groove-hq.usefulapi.io/mcp

## Tools
- groove_list_conversations (List conversations) - List support conversations (tickets) in the shared inbox, with rich filters. Filter by state, channel_id, folder_id, tag_name, assigned, starred, or keywords; paginate with first/after. Groove GraphQL: conversations(filter: ConversationFilter). Endpoint: https://groove-hq.usefulapi.io/mcp
- groove_get_conversation (Get conversation) - Get a single conversation by id — subject, state, assignment, contact, channel, counts, and tags. Groove GraphQL: conversation(id: ID!). Endpoint: https://groove-hq.usefulapi.io/mcp
- groove_list_contacts (List contacts) - List customer contacts (people who wrote in). Optional keyword search over name/email; paginate with first/after. Groove GraphQL: contacts(keywords: String). Endpoint: https://groove-hq.usefulapi.io/mcp
- groove_get_contact (Get contact) - Get a single contact by id — name, email, role, type, and conversation count. Groove GraphQL: contact(contactId: ID!). Endpoint: https://groove-hq.usefulapi.io/mcp
- groove_list_agents (List agents) - List agents (support staff / users) in the account, with role and state. Paginate with first/after. Groove GraphQL: agents. Endpoint: https://groove-hq.usefulapi.io/mcp
- groove_list_channels (List channels) - List channels (mailboxes / inboxes — email, chat, etc.) configured in the account. Paginate with first/after. Groove GraphQL: channels. Endpoint: https://groove-hq.usefulapi.io/mcp
- groove_list_tags (List tags) - List tags defined in the account (id, name, color) — use tag ids with the tag/untag write tools. Paginate with first/after. Groove GraphQL: tags. Endpoint: https://groove-hq.usefulapi.io/mcp
- groove_list_folders (List folders) - List folders (saved views / smart folders that group conversations), with conversation counts. Paginate with first/after. Groove GraphQL: folders. Endpoint: https://groove-hq.usefulapi.io/mcp
- groove_list_teams (List teams) - List teams (groups of agents that conversations can be assigned to). Paginate with first/after. Groove GraphQL: teams. Endpoint: https://groove-hq.usefulapi.io/mcp
- groove_close_conversation (Close conversation) - CLOSES a conversation (marks it resolved) in the shared inbox. Groove GraphQL: conversationClose. Endpoint: https://groove-hq.usefulapi.io/mcp
- groove_open_conversation (Open conversation) - RE-OPENS a closed/snoozed conversation in the shared inbox. Groove GraphQL: conversationOpen. Endpoint: https://groove-hq.usefulapi.io/mcp
- groove_snooze_conversation (Snooze conversation) - SNOOZES a conversation until the given time (ISO8601) — it drops out of the inbox until then. Groove GraphQL: conversationSnooze. Endpoint: https://groove-hq.usefulapi.io/mcp
- groove_star_conversation (Star conversation) - STARS a conversation (flags it for attention) in the shared inbox. Groove GraphQL: conversationStar. Endpoint: https://groove-hq.usefulapi.io/mcp
- groove_assign_conversation (Assign conversation) - ASSIGNS a conversation to an agent and/or team. Pass agent_id, team_id, or both (at least one is required). Groove GraphQL: conversationAssign. Endpoint: https://groove-hq.usefulapi.io/mcp
- groove_tag_conversation (Tag conversation) - ADDS tags (by tag id) to a conversation. Use groove_list_tags to find tag ids. Groove GraphQL: conversationTag. Endpoint: https://groove-hq.usefulapi.io/mcp
- groove_untag_conversation (Untag conversation) - REMOVES tags (by tag id) from a conversation. Use groove_list_tags to find tag ids. Groove GraphQL: conversationUntag. Endpoint: https://groove-hq.usefulapi.io/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.usefulapi
- Version: 1.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 19, 2026
- Source: https://registry.modelcontextprotocol.io