Use the Speak AI MCP server tool update_user_group to update a user group’s name
and member list.
What does it do?
Update a user group’s name and member list. NOTE: the users array is a FULL
REPLACEMENT, not a delta. Any member id you omit is removed from the group. Fetch
the current members with list_user_groups first and send the complete list.
Parameters
update_user_group takes 3 parameters, all of them required.
| Name | Type | Required | Description |
|---|---|---|---|
_id |
string | Yes | Group _id to update (from list_user_groups) |
description |
string | Yes | New group name |
users |
array of string | Yes | Full replacement list of member _id strings (omitted users are removed) |
Behaviour
The Speak AI MCP server publishes these behaviour hints for update_user_group.
- Can change data in your workspace.
- Can delete or overwrite data. Use with care.
- Repeating an identical call is safe.
- Stays inside Speak AI. Does not reach other systems.
Related
- Users & teams lists the rest of the Users & teams category.
- Tool reference lists every Speak AI MCP server tool.
- MCP server covers setup, supported clients, and what agents can do once connected.