MCP server
Groove MCP by usefulapi
Read Groove shared-inbox conversations, contacts, agents and tags; close, assign, snooze…
- Runs
- Remotely
- Version
- 1.40.0
- Listing updated
- 4 days ago
About Groove MCP by usefulapi
Groove MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read Groove shared-inbox conversations, contacts, agents and tags; close, assign, snooze and tag.
Install
Run in a terminal
claude mcp add --transport http groove-hq https://groove-hq.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://groove-hq.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"groove-hq": {
"url": "https://groove-hq.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"groove-hq": {
"type": "http",
"url": "https://groove-hq.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"groove-hq": {
"serverUrl": "https://groove-hq.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"groove-hq": {
"type": "http",
"url": "https://groove-hq.usefulapi.io/mcp"
}
}
}Tools this server provides (16)
Read directly from the server.
- 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.
Groove MCP by usefulapi 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