usefulapi

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

Claude

Open Settings → Connectors → Add custom connector
Paste this URL:
https://groove-hq.usefulapi.io/mcp
Authenticate with Groove when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

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

live18 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 18

Tool	Type	What it does
`groove_list_conversations`	read	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`	read	Get conversation Get a single conversation by id — subject, state, assignment, contact, channel, counts, and tags. Groove GraphQL: conversation(id: ID!).
`groove_list_contacts`	read	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`	read	Get contact Get a single contact by id — name, email, role, type, and conversation count. Groove GraphQL: contact(contactId: ID!).
`groove_list_agents`	read	List agents List agents (support staff / users) in the account, with role and state. Paginate with first/after. Groove GraphQL: agents.
`groove_list_channels`	read	List channels List channels (mailboxes / inboxes — email, chat, etc.) configured in the account. Paginate with first/after. Groove GraphQL: channels.
`groove_list_tags`	read	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`	read	List folders List folders (saved views / smart folders that group conversations), with conversation counts. Paginate with first/after. Groove GraphQL: folders.
`groove_list_teams`	read	List teams List teams (groups of agents that conversations can be assigned to). Paginate with first/after. Groove GraphQL: teams.
`groove_close_conversation`	write	Close conversation CLOSES a conversation (marks it resolved) in the shared inbox. Groove GraphQL: conversationClose.
`groove_open_conversation`	write	Open conversation RE-OPENS a closed/snoozed conversation in the shared inbox. Groove GraphQL: conversationOpen.
`groove_snooze_conversation`	write	Snooze conversation SNOOZES a conversation until the given time (ISO8601) — it drops out of the inbox until then. Groove GraphQL: conversationSnooze.
`groove_star_conversation`	write	Star conversation STARS a conversation (flags it for attention) in the shared inbox. Groove GraphQL: conversationStar.
`groove_assign_conversation`	write	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`	write	Tag conversation ADDS tags (by tag id) to a conversation. Use groove_list_tags to find tag ids. Groove GraphQL: conversationTag.
`groove_untag_conversation`	write	Untag conversation REMOVES tags (by tag id) from a conversation. Use groove_list_tags to find tag ids. Groove GraphQL: conversationUntag.
`groove_usage_status`	meta	Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter.
`groove_upgrade`	meta	Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED Groove tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter.

Pricing

Plan	Price	Limit
Free	$0	100 tool calls / month
Proper user	$9/mo · $90/yr	Unlimited

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.