Skip to content
MCP server

Groove MCP by usefulapi

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

Install
Runs
Remotely
Version
1.40.0
Listing updated
4 days ago

About Groove MCP by usefulapi

Groove MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

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

Install

Run in a terminal

claude mcp add --transport http groove-hq https://groove-hq.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://groove-hq.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "groove-hq": {
      "url": "https://groove-hq.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "groove-hq": {
      "type": "http",
      "url": "https://groove-hq.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "groove-hq": {
      "serverUrl": "https://groove-hq.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "groove-hq": {
      "type": "http",
      "url": "https://groove-hq.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (16)

Read directly from the server.

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.

Groove MCP by usefulapi FAQ

How do I add Groove MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http groove-hq https://groove-hq.usefulapi.io/mcp