Groove MCP by usefulapi
by usefulapi.io · remote · no sign-in to list tools · v1.16.4 · published by io.usefulapi
Read Groove shared-inbox conversations, contacts, agents and tags; close, assign, snooze and tag.
16 tools: 7 can delete or cancel things and 9 only read.
Scanned Oct 22, 2026
- Deletes or cancels7Claude Code: deny: see these tools
- Can't be undone0Claude Code: ask
- Changes things0Claude Code: ask
- Only reads9Claude Code: allow: see these tools
No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http groove-hq https://groove-hq.usefulapi.io/mcpTools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
16 tools
Deletes or cancels 7Claude Code: deny
groove_assign_conversationASSIGNS a conversation to an agent and/or team.No findings
Why it is in this group
- The name "groove_assign_conversation" says "assign": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it ASSIGNS a conversation to an agent and/or team. Pass agent_id, team_id, or both (at least one is required). Groove GraphQL: conversationAssign.
Annotations the server declares
- title: Assign conversation
- destructiveHint: true
groove_close_conversationCLOSES a conversation (marks it resolved) in the shared inbox.No findings
Why it is in this group
- The name "groove_close_conversation" says "close": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it CLOSES a conversation (marks it resolved) in the shared inbox. Groove GraphQL: conversationClose.
Annotations the server declares
- title: Close conversation
- destructiveHint: true
groove_open_conversationRE-OPENS a closed/snoozed conversation in the shared inbox.No findings
Why it is in this group
- The name "groove_open_conversation" says "open": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it RE-OPENS a closed/snoozed conversation in the shared inbox. Groove GraphQL: conversationOpen.
Annotations the server declares
- title: Open conversation
- destructiveHint: true
groove_snooze_conversationSNOOZES a conversation until the given time (ISO8601) — it drops out of the inbox until then.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it SNOOZES a conversation until the given time (ISO8601) — it drops out of the inbox until then. Groove GraphQL: conversationSnooze.
Annotations the server declares
- title: Snooze conversation
- destructiveHint: true
groove_star_conversationSTARS a conversation (flags it for attention) in the shared inbox.No findings
Why it is in this group
- The name "groove_star_conversation" says "star": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it STARS a conversation (flags it for attention) in the shared inbox. Groove GraphQL: conversationStar.
Annotations the server declares
- title: Star conversation
- destructiveHint: true
groove_tag_conversationADDS tags (by tag id) to a conversation.No findings
Why it is in this group
- The description's first verb is "add": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it ADDS tags (by tag id) to a conversation. Use groove_list_tags to find tag ids. Groove GraphQL: conversationTag.
Annotations the server declares
- title: Tag conversation
- destructiveHint: true
groove_untag_conversationREMOVES tags (by tag id) from a conversation.No findings
Why it is in this group
- The description's first verb is "remove": a word for removing or ending something.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it REMOVES tags (by tag id) from a conversation. Use groove_list_tags to find tag ids. Groove GraphQL: conversationUntag.
Annotations the server declares
- title: Untag conversation
- destructiveHint: true
Only reads 9Claude Code: allow
groove_get_contactGet a single contact by id — name, email, role, type, and conversation count.Reads private dataReads text others writeNo findings
Why it is in this group
- The name "groove_get_contact" says "get": a word for reading.
What it can reach
- private-dataThe name "groove_get_contact" says "get" and "contact": it reads contacts.
- private-dataThe description's first sentence says "get" and "contact": it reads contacts.
- untrusted-inputThe description's first sentence says "get" and "email": it reads inbound email, which other people can write.
Description, as the server wrote it Get a single contact by id — name, email, role, type, and conversation count. Groove GraphQL: contact(contactId: ID!).
Annotations the server declares
- title: Get contact
- readOnlyHint: true
groove_get_conversationGet a single conversation by id — subject, state, assignment, contact, channel, counts, and tags.Reads private dataReads text others writeNo findings
Why it is in this group
- The name "groove_get_conversation" says "get": a word for reading.
What it can reach
- private-dataThe name "groove_get_conversation" says "get" and "conversation": it reads messages.
- private-dataThe description's first sentence says "get" and "conversation": it reads messages.
- untrusted-inputThe name "groove_get_conversation" says "get" and "conversation": it reads messages, which other people can write.
- untrusted-inputThe description's first sentence says "get" and "conversation": it reads messages, which other people can write.
Description, as the server wrote it Get a single conversation by id — subject, state, assignment, contact, channel, counts, and tags. Groove GraphQL: conversation(id: ID!).
Annotations the server declares
- title: Get conversation
- readOnlyHint: true
groove_list_agentsList agents (support staff / users) in the account, with role and state.No findings
Why it is in this group
- The name "groove_list_agents" says "list": a word for reading.
Description, as the server wrote it List agents (support staff / users) in the account, with role and state. Paginate with first/after. Groove GraphQL: agents.
Annotations the server declares
- title: List agents
- readOnlyHint: true
groove_list_channelsList channels (mailboxes / inboxes — email, chat, etc.) configured in the account.Reads private dataReads text others writeNo findings
Why it is in this group
- The name "groove_list_channels" says "list": a word for reading.
What it can reach
- private-dataThe description's first sentence says "list" and "mailbox": it reads mail.
- untrusted-inputThe description's first sentence says "list" and "mailbox": it reads inbound email, which other people can write.
Description, as the server wrote it List channels (mailboxes / inboxes — email, chat, etc.) configured in the account. Paginate with first/after. Groove GraphQL: channels.
Annotations the server declares
- title: List channels
- readOnlyHint: true
groove_list_contactsList customer contacts (people who wrote in).Reads private dataNo findings
Why it is in this group
- The name "groove_list_contacts" says "list": a word for reading.
What it can reach
- private-dataThe name "groove_list_contacts" says "list" and "contact": it reads contacts.
- private-dataThe description's first sentence says "list" and "contact": it reads contacts.
Description, as the server wrote it List customer contacts (people who wrote in). Optional keyword search over name/email; paginate with first/after. Groove GraphQL: contacts(keywords: String).
Annotations the server declares
- title: List contacts
- readOnlyHint: true
groove_list_conversationsList support conversations (tickets) in the shared inbox, with rich filters.Reads private dataReads text others writeNo findings
Why it is in this group
- The name "groove_list_conversations" says "list": a word for reading.
What it can reach
- private-dataThe name "groove_list_conversations" says "list" and "conversation": it reads messages.
- private-dataThe description's first sentence says "list" and "conversation": it reads messages.
- private-dataThe input names a folder (input.folder_id), and the tool reads: it reads files.
- untrusted-inputThe name "groove_list_conversations" says "list" and "conversation": it reads messages, which other people can write.
- untrusted-inputThe description's first sentence says "list" and "conversation": it reads messages, which other people can write.
Description, as the server wrote it 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).
Annotations the server declares
- title: List conversations
- readOnlyHint: true
groove_list_foldersList folders (saved views / smart folders that group conversations), with conversation counts.Reads private dataReads text others writeNo findings
Why it is in this group
- The name "groove_list_folders" says "list": a word for reading.
What it can reach
- private-dataThe name "groove_list_folders" says "list" and "folder": it reads files.
- private-dataThe description's first sentence says "list" and "folder": it reads files.
- untrusted-inputThe description's first sentence says "list" and "conversation": it reads messages, which other people can write.
Description, as the server wrote it List folders (saved views / smart folders that group conversations), with conversation counts. Paginate with first/after. Groove GraphQL: folders.
Annotations the server declares
- title: List folders
- readOnlyHint: true
groove_list_tagsList tags defined in the account (id, name, color) — use tag ids with the tag/untag write tools.No findings
Why it is in this group
- The name "groove_list_tags" says "list": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: List tags
- readOnlyHint: true
groove_list_teamsList teams (groups of agents that conversations can be assigned to).Reads private dataReads text others writeNo findings
Why it is in this group
- The name "groove_list_teams" says "list": a word for reading.
What it can reach
- private-dataThe description's first sentence says "list" and "conversation": it reads messages.
- untrusted-inputThe description's first sentence says "list" and "conversation": it reads messages, which other people can write.
Description, as the server wrote it List teams (groups of agents that conversations can be assigned to). Paginate with first/after. Groove GraphQL: teams.
Annotations the server declares
- title: List teams
- readOnlyHint: true
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Exfil surface
Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.
No private-data, untrusted-input, outbound path in this server alone: no tool is tagged outbound.
- Reads private data7
- Reads files, mail, messages, databases, secrets, calendars or repositories.
- Reads text others write6
- Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
- Can send data out0
- Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.
Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.
Install
Pinned to version 1.16.4. Values in angle brackets are yours to fill in.
claude mcp add --transport http groove-hq https://groove-hq.usefulapi.io/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__groove-hq__groove_list_conversations",
"mcp__groove-hq__groove_get_conversation",
"mcp__groove-hq__groove_list_contacts",
"mcp__groove-hq__groove_get_contact",
"mcp__groove-hq__groove_list_agents",
"mcp__groove-hq__groove_list_channels",
"mcp__groove-hq__groove_list_tags",
"mcp__groove-hq__groove_list_folders",
"mcp__groove-hq__groove_list_teams"
],
"ask": [],
"deny": [
"mcp__groove-hq__groove_close_conversation",
"mcp__groove-hq__groove_open_conversation",
"mcp__groove-hq__groove_snooze_conversation",
"mcp__groove-hq__groove_star_conversation",
"mcp__groove-hq__groove_assign_conversation",
"mcp__groove-hq__groove_tag_conversation",
"mcp__groove-hq__groove_untag_conversation"
]
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as groove-hq. Review it before you use it.
Capability tags behind 7 rules
- mcp__groove-hq__groove_list_conversations private-data, untrusted-input
- mcp__groove-hq__groove_get_conversation private-data, untrusted-input
- mcp__groove-hq__groove_list_contacts private-data
- mcp__groove-hq__groove_get_contact private-data, untrusted-input
- mcp__groove-hq__groove_list_channels private-data, untrusted-input
- mcp__groove-hq__groove_list_folders private-data, untrusted-input
- mcp__groove-hq__groove_list_teams private-data, untrusted-input