Groove MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.36.4Updated Nov 7, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server for the Groove shared inbox: read support conversations, contacts and tags, and close, assign, snooze or tag them.

What you can do
  • List and read conversations with filters for state, channel, folder, tag, assignee, starred or keywords, and fetch a single conversation by id.
  • Look up contacts, agents, channels, tags, folders and teams, including paginated lists and keyword search over contacts.
  • Change conversation state: close, re-open, snooze until a given time, or star.
  • Assign conversations to an agent and/or team, and add or remove tags by tag id.
  • Check monthly usage, request a missing feature, and upgrade or cancel the paid plan.
When to use it
Useful when a support team works in Groove and wants an assistant to answer questions about the shared inbox, such as open or unassigned conversations, or to triage tickets by closing, assigning, snoozing and tagging them.
Requirements
Remote streamable HTTP endpoint; no local install. Connect with the endpoint URL only, then sign in through OAuth with your Groove credentials and paste a Groove API token (Groove → Settings → API), which is stored per user. A free plan allows 50 tool calls per month.
Before you install
Write tools change shared-inbox data: closing, re-opening, snoozing, starring, assigning, tagging and untagging conversations; confirm before running them. The Groove API token is a credential and is stored by the hosted provider. Paid plans cost money (Pro $9/month or $90/year, Pro+ $39/month or $390/year) and upgrade returns a Stripe Checkout link; cancellation runs to the end of the paid period with no refund for the current period.

Installation

In SourceWeft

  1. Open Groove MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fgroove-hq/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

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:
json
{  "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.

Tools

ToolTypeWhat it does
groove_list_conversationsreadList conversations
groove_get_conversationreadGet conversation
groove_list_contactsreadList contacts
groove_get_contactreadGet contact
groove_list_agentsreadList agents
groove_list_channelsreadList channels
groove_list_tagsreadList tags
groove_list_foldersreadList folders
groove_list_teamsreadList teams
groove_close_conversationwriteClose conversation
groove_open_conversationwriteOpen conversation
groove_snooze_conversationwriteSnooze conversation
groove_star_conversationwriteStar conversation
groove_assign_conversationwriteAssign conversation
groove_tag_conversationwriteTag conversation
groove_untag_conversationwriteUntag conversation
groove_usage_statusmetaUsage status (free-tier meter)
groove_request_featuremetaRequest a missing feature
groove_upgrademetaUpgrade to Pro or Pro+
groove_cancel_subscriptionmetaCancel 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

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with groove_upgrade (it returns a Stripe Checkout link). Cancel any time with groove_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running groove_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/groove-hq/README.md at commit 4046075

Tools

16

groove_list_conversations

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

Parametersafterfirststatestarredassignedkeywordstag_namefolder_idchannel_id

groove_get_conversation

Get conversation

Get a single conversation by id — subject, state, assignment, contact, channel, counts, and tags. Groove GraphQL: conversation(id: ID!).

Parametersidrequired

groove_list_contacts

List contacts

List customer contacts (people who wrote in). Optional keyword search over name/email; paginate with first/after. Groove GraphQL: contacts(keywords: String).

Parametersafterfirstkeywords

groove_get_contact

Get contact

Get a single contact by id — name, email, role, type, and conversation count. Groove GraphQL: contact(contactId: ID!).

Parametersidrequired

groove_list_agents

List agents

List agents (support staff / users) in the account, with role and state. Paginate with first/after. Groove GraphQL: agents.

Parametersafterfirst

groove_list_channels

List channels

List channels (mailboxes / inboxes — email, chat, etc.) configured in the account. Paginate with first/after. Groove GraphQL: channels.

Parametersafterfirst

groove_list_tags

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.

Parametersafterfirst

groove_list_folders

List folders

List folders (saved views / smart folders that group conversations), with conversation counts. Paginate with first/after. Groove GraphQL: folders.

Parametersafterfirst

groove_list_teams

List teams

List teams (groups of agents that conversations can be assigned to). Paginate with first/after. Groove GraphQL: teams.

Parametersafterfirst

groove_close_conversation

Close conversation

CLOSES a conversation (marks it resolved) in the shared inbox. Groove GraphQL: conversationClose.

Parametersidrequired

groove_open_conversation

Open conversation

RE-OPENS a closed/snoozed conversation in the shared inbox. Groove GraphQL: conversationOpen.

Parametersidrequired

groove_snooze_conversation

Snooze conversation

SNOOZES a conversation until the given time (ISO8601) — it drops out of the inbox until then. Groove GraphQL: conversationSnooze.

Parametersidrequireduntilrequired

groove_star_conversation

Star conversation

STARS a conversation (flags it for attention) in the shared inbox. Groove GraphQL: conversationStar.

Parametersidrequired

groove_assign_conversation

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.

Parametersidrequiredteam_idagent_id

groove_tag_conversation

Tag conversation

ADDS tags (by tag id) to a conversation. Use groove_list_tags to find tag ids. Groove GraphQL: conversationTag.

Parametersidrequiredtag_idsrequired

groove_untag_conversation

Untag conversation

REMOVES tags (by tag id) from a conversation. Use groove_list_tags to find tag ids. Groove GraphQL: conversationUntag.

Parametersidrequiredtag_idsrequired

Version history

21
  1. v1.36.4LatestNov 7, 2026
  2. v1.35.3Nov 5, 2026
  3. v1.35.2Nov 5, 2026
  4. v1.35.1Nov 4, 2026
  5. v1.35.0Nov 3, 2026
  6. v1.34.1Nov 3, 2026
  7. v1.33.0Nov 1, 2026
  8. v1.31.0Oct 31, 2026
  9. v1.30.0Oct 31, 2026
  10. v1.29.2Oct 30, 2026
  11. v1.29.0Oct 30, 2026
  12. v1.24.0Oct 26, 2026
  13. v1.21.3Oct 25, 2026
  14. v1.21.0Oct 25, 2026
  15. v1.20.0Oct 24, 2026
  16. v1.17.0Oct 23, 2026
  17. v1.16.4Oct 22, 2026
  18. v1.16.3Oct 21, 2026
  19. v1.11.1Oct 9, 2026
  20. v1.10.0Oct 9, 2026
  21. v1.0.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.

Streamable HTTPWeb executable
Cloud & Infrastructure15 toolsNov 7, 2026

Woffu MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

Weekdone MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.

Streamable HTTPWeb executable
Data & Analytics15 toolsNov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026