io.usefulapi/groove-hq

Groove MCP by usefulapi

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

1.11.1
Version
remote
Transport
16
Tools

Security review

Review passed

Reviewed 1d ago.

  • tools: 16 tools scanned
  • metadata: scanned

No findings.

Tools (16)

  • groove_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).

  • groove_get_conversation

    Get a single conversation by id — subject, state, assignment, contact, channel, counts, and tags. Groove GraphQL: conversation(id: ID!).

  • groove_list_contacts

    List customer contacts (people who wrote in). Optional keyword search over name/email; paginate with first/after. Groove GraphQL: contacts(keywords: String).

  • groove_get_contact

    Get a single contact by id — name, email, role, type, and conversation count. Groove GraphQL: contact(contactId: ID!).

  • groove_list_agents

    List agents (support staff / users) in the account, with role and state. Paginate with first/after. Groove GraphQL: agents.

  • groove_list_channels

    List channels (mailboxes / inboxes — email, chat, etc.) configured in the account. Paginate with first/after. Groove GraphQL: channels.

  • groove_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.

  • groove_list_folders

    List folders (saved views / smart folders that group conversations), with conversation counts. Paginate with first/after. Groove GraphQL: folders.

  • groove_list_teams

    List teams (groups of agents that conversations can be assigned to). Paginate with first/after. Groove GraphQL: teams.

  • groove_close_conversation

    CLOSES a conversation (marks it resolved) in the shared inbox. Groove GraphQL: conversationClose.

  • groove_open_conversation

    RE-OPENS a closed/snoozed conversation in the shared inbox. Groove GraphQL: conversationOpen.

  • groove_snooze_conversation

    SNOOZES a conversation until the given time (ISO8601) — it drops out of the inbox until then. Groove GraphQL: conversationSnooze.

  • groove_star_conversation

    STARS a conversation (flags it for attention) in the shared inbox. Groove GraphQL: conversationStar.

  • groove_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.

  • groove_tag_conversation

    ADDS tags (by tag id) to a conversation. Use groove_list_tags to find tag ids. Groove GraphQL: conversationTag.

  • groove_untag_conversation

    REMOVES tags (by tag id) from a conversation. Use groove_list_tags to find tag ids. Groove GraphQL: conversationUntag.