Groove MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.36.5更新於 Nov 8, 2026

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

發布方自己的服務:Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行溝通與協作商業與電商

概覽

AI 產生的概覽

託管的 Groove 共享收件匣 MCP 伺服器:讀取客服對話、聯絡人與標籤,並可關閉、指派、暫停或加上標籤。

可以做什麼
  • 依狀態、管道、資料夾、標籤、負責人、星號或關鍵字篩選並列出對話,也可用 id 取得單一對話。
  • 查詢聯絡人、客服人員、管道、標籤、資料夾與團隊,支援分頁清單及聯絡人關鍵字搜尋。
  • 變更對話狀態:關閉、重新開啟、暫停到指定時間或加上星號。
  • 將對話指派給客服人員和/或團隊,並依標籤 id 加上或移除標籤。
  • 查看當月用量、提出功能需求,以及升級或取消付費方案。
適用情境
適合使用 Groove 的客服團隊,讓助理回答共享收件匣的相關問題(例如未關閉或未指派的對話),或對工單進行關閉、指派、暫停與加標籤等分流處理。
執行需求
遠端 streamable HTTP 端點,不需本機安裝。只要填入端點網址,接著透過 OAuth 以 Groove 帳號登入並貼上 Groove API 權杖(Groove → Settings → API),權杖依使用者儲存。免費方案每月 50 次工具呼叫。
安裝前請注意
寫入類工具會變更共享收件匣資料:關閉、重新開啟、暫停、加星號、指派、加上與移除標籤,執行前應先確認。Groove API 權杖屬於憑證,由託管服務商儲存。付費方案需要付費(Pro 每月 9 美元或每年 90 美元,Pro+ 每月 39 美元或每年 390 美元),升級會回傳 Stripe 結帳連結;取消後服務持續到已付費期間結束,當期不退款。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Groove MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Fgroove-hq/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

來源:servers/groove-hq/README.md,提交 4046075

工具

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

輸入參數afterfirststatestarredassignedkeywordstag_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!).

輸入參數id必填

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

輸入參數afterfirstkeywords

groove_get_contact

Get contact

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

輸入參數id必填

groove_list_agents

List agents

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

輸入參數afterfirst

groove_list_channels

List channels

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

輸入參數afterfirst

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.

輸入參數afterfirst

groove_list_folders

List folders

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

輸入參數afterfirst

groove_list_teams

List teams

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

輸入參數afterfirst

groove_close_conversation

Close conversation

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

輸入參數id必填

groove_open_conversation

Open conversation

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

輸入參數id必填

groove_snooze_conversation

Snooze conversation

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

輸入參數id必填until必填

groove_star_conversation

Star conversation

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

輸入參數id必填

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.

輸入參數id必填team_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.

輸入參數id必填tag_ids必填

groove_untag_conversation

Untag conversation

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

輸入參數id必填tag_ids必填

版本歷史

21
  1. v1.36.4Nov 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

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合