Skip to content

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.

Deletes · 7

16 tools: 7 can delete or cancel things and 9 only read.

Scanned Oct 22, 2026

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/mcp

Tools

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 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/mcp

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

.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