Groove MCP by usefulapi
Manage Groove support conversations from Claude, Cursor, or any MCP client โ
read shared-inbox conversations, contacts, agents, channels, tags, folders and teams, and close, open,
snooze, star, assign or tag conversations. Hosted, no local install: connect with your Groove API token.
Live endpoint: https://groove-hq.usefulapi.io/mcp ยท Homepage: https://usefulapi.io
Connect
- Claude (claude.ai, Desktop): open Customize โ Connectors, click + Add โ Add custom connector, and paste
https://groove-hq.usefulapi.io/mcp.
- Claude Code:
claude mcp add --transport http groove-hq https://groove-hq.usefulapi.io/mcp, then run /mcp to log in.
- VS Code: Add to VS Code.
- Cursor and other clients: add the URL as a remote MCP server:
{
"mcpServers": {
"groove-hq": {
"url": "https://groove-hq.usefulapi.io/mcp"
}
}
}
Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Groove credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/groove-hq/
On first connect you'll paste your Groove API token (Groove โ Settings โ API).
It's validated, stored per-user, and scoped to you โ no keys in config files.
| Tool | Type | What it does |
|---|
groove_list_conversations | read | List conversations |
groove_get_conversation | read | Get conversation |
groove_list_contacts | read | List contacts |
groove_get_contact | read | Get contact |
groove_list_agents | read | List agents |
groove_list_channels | read | List channels |
groove_list_tags | read | List tags |
groove_list_folders | read | List folders |
groove_list_teams | read | List teams |
groove_close_conversation | write | Close conversation |
groove_open_conversation | write | Open conversation |
groove_snooze_conversation | write | Snooze conversation |
groove_star_conversation | write | Star conversation |
groove_assign_conversation | write | Assign conversation |
groove_tag_conversation | write | Tag conversation |
groove_untag_conversation | write | Untag conversation |
groove_usage_status | meta | Usage status (free-tier meter) |
groove_request_feature | meta | Request a missing feature |
groove_upgrade | meta | Upgrade to Pro or Pro+ |
groove_cancel_subscription | meta | Cancel the Pro subscription |
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
Pricing
| Plan | Price | Limit |
|---|
| Free | $0 | 50 tool calls / month |
| Pro (per user) | $9/mo or $90/yr (2 months free) | 10,000 tool calls / month |
| Pro+ (per user) | $39/mo or $390/yr (2 months free) | 100,000 tool calls / month |
Each paid plan covers this server only. Ask your AI to run groove_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with groove_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with groove_upgrade before then undoes the cancel. Or write to support@usefulapi.io.
License
MIT โ see LICENSE. Documentation only; the server is hosted.