INDIVIDUAL MCP TOOL

groove_list_conversations

List support conversations (tickets) in the shared inbox, with rich filters.

usefulapi.ionone authenticationAvailability not checked

LIVE ENDPOINT

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

No auth detected

Connect to this endpoint to inspect the live schema for groove_list_conversations and invoke it with your own arguments.

{}

Inferred read-only · medium confidence · heuristic, not a guarantee.

No write-capable action terms were found; this is not proof that invocation has no side effects.

CONNECT WITH APPROVAL

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.groove-hq-mcp]
url = "https://groove-hq.usefulapi.io/mcp"
enabled = true

Claude Code

.mcp.json

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

Claude Desktop

Settings → Connectors → Add custom connector

Name: groove-hq-mcp
Remote MCP URL: https://groove-hq.usefulapi.io/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

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

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

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

Generic MCP

Client-specific MCP configuration

{
  "name": "groove-hq-mcp",
  "transport": "streamable-http",
  "url": "https://groove-hq.usefulapi.io/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

groove_get_conversation — Get a single conversation by id — subject, state, assignment, contact, channel, counts, and tags.
groove_list_contacts — List customer contacts (people who wrote in).
groove_get_contact — Get a single contact by id — name, email, role, type, and conversation count.
groove_list_agents — List agents (support staff / users) in the account, with role and state.
groove_list_channels — List channels (mailboxes / inboxes — email, chat, etc.
groove_list_tags — List tags defined in the account (id, name, color) — use tag ids with the tag/untag write tools.
groove_list_folders — List folders (saved views / smart folders that group conversations), with conversation counts.
groove_list_teams — List teams (groups of agents that conversations can be assigned to).