# Groove MCP by usefulapi

> Groove MCP by usefulapi is an MCP server. Read Groove shared-inbox conversations, contacts, agents and tags; close, assign, snooze and tag. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/groove-hq/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/groove-hq
- **MCP Registry name:** io.usefulapi/groove-hq
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://groove-hq.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "groove-hq": {
      "url": "https://groove-hq.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/groove-mcp-by-usefulapi
