# group — gitlab

> 75 actions
> This page as plain markdown. Index: https://mcp.jmrp.io/llms.txt

Canonical: https://mcp.jmrp.io/servers/gitlab/actions/group/
Language: en
Alternate: https://mcp.jmrp.io/es/servers/gitlab/actions/group/index.md
Updated: 2026-09-11T09:56:41+02:00
License: https://mcp.jmrp.io/license/

Counted with a Free-tier token against gitlab.com, which is the only host this endpoint talks to: to use it against a self-managed instance, run the server yourself — its documentation covers that. The catalog is scoped to the token that asks, so the count moves with both its tier and its permissions: higher tiers expose more actions, and administration domains only appear to tokens allowed to use them. That is why the figures differ elsewhere: the upstream project catalogues 1,006 actions across 162 domains, and 851 on the Free/CE surface, while this deployment publishes 747 because it is OAuth-only and acts with your token, so the administration domains a non-admin account cannot call never appear. All three describe the same catalog, counted from three vantage points.

## Actions

### `group.archive` — Group Archive

Archive a GitLab group, making it and its projects read-only in GitLab. Returns: a success confirmation. See also: group.unarchive, group.get, group.update.

**Required parameters:** `group_id (string)`

### `group.badge_add` — Add Group Badge

Add a badge to a group. Returns: the created badge with id, name, link_url, image_url, rendered_link_url, rendered_image_url, and kind. See also: group.badge_list, group.badge_get.

**Required parameters:** `group_id (string)`, `image_url (string)`, `link_url (string)`

### `group.badge_delete` — Delete Group Badge

_destructive_

Delete a group badge by badge_id. Returns: a success confirmation. See also: group.badge_list, group.badge_get.

**Required parameters:** `badge_id (integer)`, `group_id (string)`

### `group.badge_edit` — Edit Group Badge

Edit a group badge's name, link_url, or image_url. Returns: the updated badge with id, name, link_url, image_url, rendered_link_url, rendered_image_url, and kind. See also: group.badge_list, group.badge_get.

**Required parameters:** `badge_id (integer)`, `group_id (string)`

### `group.badge_get` — Get Group Badge

_read-only_

Get a single group badge by badge_id. Returns: the badge with id, name, link_url, image_url, rendered_link_url, rendered_image_url, and kind. See also: group.badge_list, group.badge_edit.

**Required parameters:** `badge_id (integer)`, `group_id (string)`

### `group.badge_list` — List Group Badges

_read-only_

List badges for a group, including inherited group badges. Returns: badges (id, name, link_url, image_url, rendered_link_url, rendered_image_url, and kind) plus pagination metadata. See also: group.badge_get, group.badge_add.

**Required parameters:** `group_id (string)`

### `group.badge_preview` — Preview Group Badge

_read-only_

Preview how a group badge's link_url and image_url resolve after placeholder interpolation, without persisting it. Returns: the rendered badge with id, name, link_url, image_url, rendered_link_url, rendered_image_url, and kind. See also: group.badge_add, group.badge_list.

**Required parameters:** `group_id (string)`, `image_url (string)`, `link_url (string)`

### `group.create` — Group Create

Create a GitLab group or subgroup. Returns: created group metadata including ID, full path, and visibility. See also: group.get, group.update, group.delete.

**Required parameters:** `name (string)`

### `group.delete` — Group Delete

_destructive_

Delete a GitLab group and its projects. Returns: a success confirmation. See also: group.restore, group.get, group.update.

**Required parameters:** `group_id (string)`

### `group.get` — Group Get

_read-only_

Get one GitLab group by ID or path. Returns: group metadata, visibility, parent information, and web URL. See also: group.list, group.members, group.projects, group.update.

**Required parameters:** `group_id (string)`

### `group.group_board_create_list` — Group Board List Create

Create a new list (column) on a group issue board from a group label. Returns: the created list with its label and scope. See also: group.group_board_get_list, group.group_board_update_list, group.group_board_delete_list.

**Required parameters:** `board_id (integer)`, `group_id (string)`, `label_id (integer)`

### `group.group_board_delete` — Group Board Delete

_destructive_

Delete a group issue board permanently. Returns: a success confirmation. See also: group.group_board_get, group.group_board_list.

**Required parameters:** `board_id (integer)`, `group_id (string)`

### `group.group_board_delete_list` — Group Board List Delete

_destructive_

Delete a list (column) from a group issue board. Returns: a success confirmation. See also: group.group_board_get_list, group.group_board_list_lists.

**Required parameters:** `board_id (integer)`, `group_id (string)`, `list_id (integer)`

### `group.group_board_get` — Group Board Get

_read-only_

Get a single group issue board by ID. Returns: the board with its group, milestone, scope labels, and lists. See also: group.group_board_list, group.group_board_update, group.group_board_list_lists.

**Required parameters:** `board_id (integer)`, `group_id (string)`

### `group.group_board_get_list` — Group Board List Get

_read-only_

Get a single list (column) of a group issue board. Returns: the list with its assignee, label, iteration, and milestone scope. See also: group.group_board_list_lists, group.group_board_update_list, group.group_board_delete_list.

**Required parameters:** `board_id (integer)`, `group_id (string)`, `list_id (integer)`

### `group.group_board_list` — Group Board List

_read-only_

List all issue boards in a group with pagination. Returns: each board with its group, milestone, scope labels, lists, and pagination metadata. See also: group.group_board_get, group.group_board_list_lists.

**Required parameters:** `group_id (string)`

### `group.group_board_list_lists` — Group Board List Lists

_read-only_

List the lists (columns) of a group issue board with pagination. Returns: each list with its assignee, label, iteration, and milestone scope plus pagination metadata. See also: group.group_board_get_list, group.group_board_create_list, group.group_board_get.

**Required parameters:** `board_id (integer)`, `group_id (string)`

### `group.group_board_update` — Group Board Update

Update a group issue board's name and scope (assignee, milestone, labels, weight). Returns: the updated board with its group, milestone, labels, and lists. See also: group.group_board_get, group.group_board_list.

**Required parameters:** `board_id (integer)`, `group_id (string)`

### `group.group_board_update_list` — Group Board List Update

Reorder a list (column) within a group issue board. Returns: the repositioned list with its scope. See also: group.group_board_get_list, group.group_board_list_lists.

**Required parameters:** `board_id (integer)`, `group_id (string)`, `list_id (integer)`, `position (integer)`

### `group.group_export_download` — Download Group Export

_read-only_

Download a group's finished export archive. Returns: the export archive as base64 content plus its size in bytes. See also: group.group_export_schedule, group.group_import_file, group.get.

**Required parameters:** `group_id (string)`

### `group.group_export_schedule` — Schedule Group Export

Schedule an asynchronous export of a GitLab group. Returns: a confirmation that the export was scheduled (the archive is built in the background). See also: group.group_export_download, group.group_import_file, group.get.

**Required parameters:** `group_id (string)`

### `group.group_import_file` — Import Group From File

Import a group from a local export archive. Returns: a confirmation that the import started (GitLab builds the group asynchronously). See also: group.group_export_schedule, group.group_export_download, group.list.

**Required parameters:** `file (string)`, `name (string)`, `path (string)`

### `group.group_label_create` — Group Label Create

Create a new group label. Returns: the created label with id, name, color, text color, description, counts, priority, and subscription state. See also: group.group_label_list, group.group_label_get, group.group_label_update.

**Required parameters:** `color (string)`, `group_id (string)`, `name (string)`

### `group.group_label_delete` — Group Label Delete

_destructive_

Delete a group label permanently. Returns: a success confirmation. See also: group.group_label_get, group.group_label_list.

**Required parameters:** `group_id (string)`, `label_id (string)`

### `group.group_label_get` — Group Label Get

_read-only_

Get a single group label by ID or name. Returns: the label with color, text color, description, issue and merge request counts, priority, and subscription state. See also: group.group_label_list, group.group_label_update, group.group_label_delete.

**Required parameters:** `group_id (string)`, `label_id (string)`

### `group.group_label_list` — Group Label List

_read-only_

List labels in a group with filtering and pagination. Returns: matching labels with color, text color, description, issue and merge request counts, priority, subscription state, and pagination metadata. See also: group.group_label_get, group.group_label_create, group.get.

**Required parameters:** `group_id (string)`

### `group.group_label_subscribe` — Group Label Subscribe

Subscribe to a group label's notifications. Returns: the label with the updated subscription state. See also: group.group_label_get, group.group_label_unsubscribe.

**Required parameters:** `group_id (string)`, `label_id (string)`

### `group.group_label_unsubscribe` — Group Label Unsubscribe

Unsubscribe from a group label's notifications. Returns: a success confirmation. See also: group.group_label_get, group.group_label_subscribe.

**Required parameters:** `group_id (string)`, `label_id (string)`

### `group.group_label_update` — Group Label Update

Update a group label. Returns: the updated label with id, name, color, text color, description, counts, priority, and subscription state. See also: group.group_label_get, group.group_label_list, group.group_label_delete.

**Required parameters:** `group_id (string)`, `label_id (string)`

### `group.group_member_add` — Group Member Add

Add a user as a direct member of a group. Returns: the created membership with access level, custom member role, expiry, and seat usage. See also: group.members, group.group_member_edit, group.group_member_get.

**Required parameters:** `group_id (string)`, `user_id (integer)`

### `group.group_member_edit` — Group Member Edit

Edit a direct group member's access level, expiry, or custom member role. Returns: the updated membership. See also: group.members, group.group_member_get, group.group_member_remove.

**Required parameters:** `group_id (string)`, `user_id (integer)`

### `group.group_member_get` — Group Member Get

_read-only_

Get a single direct member of a group by user ID. Returns: access level, custom member role, created_by, expiry, public email, SAML identity, and seat usage. See also: group.members, group.group_member_get_inherited, group.group_member_edit.

**Required parameters:** `group_id (string)`, `user_id (integer)`

### `group.group_member_get_inherited` — Group Member Get Inherited

_read-only_

Get a single member of a group including inherited memberships from ancestor groups. Returns: effective access level, custom member role, created_by, expiry, public email, SAML identity, and seat usage. See also: group.group_member_get, group.members, group.group_member_edit.

**Required parameters:** `group_id (string)`, `user_id (integer)`

### `group.group_member_remove` — Group Member Remove

_destructive_

Remove a direct member from a group (destructive, requires confirmation). Returns: a delete confirmation. See also: group.members, group.group_member_get, group.group_member_edit.

**Required parameters:** `group_id (string)`, `user_id (integer)`

### `group.group_member_share` — Group Share

Share a group with another group at a chosen access level. Returns: the shared group's id, name, path, and web URL. See also: group.group_member_unshare, group.get, group.members.

**Required parameters:** `group_id (string)`, `share_group_id (integer)`

### `group.group_member_unshare` — Group Unshare

_destructive_

Revoke an existing group-to-group share (destructive, requires confirmation). Returns: a delete confirmation. See also: group.group_member_share, group.get, group.members.

**Required parameters:** `group_id (string)`, `share_group_id (integer)`

### `group.group_milestone_create` — Group Milestone Create

Create a new group milestone. Returns: the created milestone with ID, IID, state, start and due dates. See also: group.group_milestone_get, group.group_milestone_list, group.group_milestone_update.

**Required parameters:** `group_id (string)`, `title (string)`

### `group.group_milestone_delete` — Group Milestone Delete

_destructive_

Delete a group milestone permanently. Returns: a success confirmation. See also: group.group_milestone_get, group.group_milestone_update.

**Required parameters:** `group_id (string)`, `milestone_iid (integer)`

### `group.group_milestone_get` — Group Milestone Get

_read-only_

Get a single group milestone by IID. Returns: milestone metadata, state, start and due dates, expiry, and timestamps. See also: group.group_milestone_list, group.group_milestone_update, group.group_milestone_issues.

**Required parameters:** `group_id (string)`, `milestone_iid (integer)`

### `group.group_milestone_issues` — Group Milestone Issues

_read-only_

List issues assigned to a group milestone. Returns: assigned issues with state, web URL, and pagination metadata. See also: group.group_milestone_get, group.group_milestone_merge_requests, issue.list_group.

**Required parameters:** `group_id (string)`, `milestone_iid (integer)`

### `group.group_milestone_list` — Group Milestone List

_read-only_

List milestones in a group with filtering and pagination. Returns: matching group milestones with state, dates, expiry, and pagination metadata. See also: group.group_milestone_get, group.group_milestone_create, project.milestone_list.

**Required parameters:** `group_id (string)`

### `group.group_milestone_merge_requests` — Group Milestone Merge Requests

_read-only_

List merge requests assigned to a group milestone. Returns: assigned merge requests with state, source and target branches, and pagination metadata. See also: group.group_milestone_get, group.group_milestone_issues.

**Required parameters:** `group_id (string)`, `milestone_iid (integer)`

### `group.group_milestone_update` — Group Milestone Update

Update an existing group milestone. Returns: the updated milestone with state, dates, and expiry. See also: group.group_milestone_get, group.group_milestone_list, group.group_milestone_delete.

**Required parameters:** `group_id (string)`, `milestone_iid (integer)`

### `group.group_relations_list_status` — List Group Relations Export Status

_read-only_

List the status of a group's relations export, optionally filtered by relation. Returns: per-relation export status, error detail, batched flag, batch count, per-batch progress, and pagination metadata. See also: group.group_relations_schedule, group.get.

**Required parameters:** `group_id (string)`

### `group.group_relations_schedule` — Schedule Group Relations Export

Schedule a new export of a group's relations (issues, labels, milestones, and more). Returns: a confirmation that the asynchronous export was scheduled. See also: group.group_relations_list_status, group.get.

**Required parameters:** `group_id (string)`

### `group.group_upload_delete_by_id` — Delete Group Markdown Upload By ID

_destructive_

Delete a group Markdown upload by its numeric upload ID. Returns: a success confirmation. See also: group.group_upload_list, group.group_upload_delete_by_secret.

**Required parameters:** `group_id (string)`, `upload_id (integer)`

### `group.group_upload_delete_by_secret` — Delete Group Markdown Upload By Secret

_destructive_

Delete a group Markdown upload by its 32-character secret and filename. Returns: a success confirmation. See also: group.group_upload_list, group.group_upload_delete_by_id.

**Required parameters:** `filename (string)`, `group_id (string)`, `secret (string)`

### `group.group_upload_list` — List Group Markdown Uploads

_read-only_

List all Markdown uploads in a group. Returns: each upload's id, filename, size, creation time, and uploader (id, username, name, state, avatar, web URL), plus pagination metadata. See also: group.group_upload_delete_by_id, group.group_upload_delete_by_secret, group.get.

**Required parameters:** `group_id (string)`

### `group.invited_groups` — Group Invited List

_read-only_

List groups invited to a GitLab group. Returns: the invited groups with path and access metadata. See also: group.shared_with, group.members, group.get.

**Required parameters:** `group_id (string)`

### `group.issues` — Issue List Group

_read-only_

List issues across a group. Returns: matching issues from projects in the group with pagination metadata. See also: issue.list, group.get, search.issues.

**Required parameters:** `group_id (string)`

### `group.list` — Group List

_read-only_

List accessible GitLab groups with filtering and pagination. Returns: matching groups including path, name, and visibility metadata. See also: group.get, group.search, group.create.

### `group.members` — Group Members List

_read-only_

List the members of a GitLab group (direct and inherited). Returns: members with username, access level, and seat/role metadata. See also: group.get, group.projects, group.group_member_add.

**Required parameters:** `group_id (string)`

### `group.projects` — Group Projects

_read-only_

List the projects in a GitLab group. Returns: projects with path, visibility, and archived status. See also: group.get, group.subgroups, group.transfer_project.

**Required parameters:** `group_id (string)`

### `group.release_list` — Group Release List

_read-only_

List releases across all projects in a group with pagination, ordering, and keyset support. Returns: tag names, release names, dates, author, commit, assets, milestones, evidences, and _links per release. See also: group.get, release.list, release.get.

**Required parameters:** `group_id (string)`

### `group.restore` — Group Restore

Restore a GitLab group marked for deletion. Returns: the restored group metadata. See also: group.delete, group.get, group.list.

**Required parameters:** `group_id (string)`

### `group.search` — Group Search

_read-only_

Search GitLab groups by name or path. Returns: matching groups with path, name, and visibility. See also: group.list, group.get, group.create.

**Required parameters:** `query (string)`

### `group.service_account_create` — Group Service Account Create

Create a service account user in a group. Use for GitLab group service accounts and their personal access tokens. Do not use group members, SCIM identities, enterprise users, or generic group access tokens for service account CRUD. Available on all tiers (Free, Premium, Ultimate). Requires Owner permissions. Omit email unless the task gives an explicit valid email address.

**Required parameters:** `group_id (string)`

### `group.service_account_delete` — Group Service Account Delete

_destructive_

Delete a group service account user, optionally hard-deleting owned resources. Use for GitLab group service accounts and their personal access tokens. Do not use group members, SCIM identities, enterprise users, or generic group access tokens for service account CRUD. Available on all tiers (Free, Premium, Ultimate). Requires Owner permissions.

**Required parameters:** `group_id (string)`, `service_account_id (integer)`

### `group.service_account_list` — Group Service Account List

_read-only_

List a group's service account users. Use for GitLab group service accounts and their personal access tokens. Do not use group members, SCIM identities, enterprise users, or generic group access tokens for service account CRUD. Available on all tiers (Free, Premium, Ultimate). Requires Owner permissions.

**Required parameters:** `group_id (string)`

### `group.service_account_pat_create` — Group Service Account Pat Create

Create a personal access token for a group service account. Use for GitLab group service accounts and their personal access tokens. Do not use group members, SCIM identities, enterprise users, or generic group access tokens for service account CRUD. Available on all tiers (Free, Premium, Ultimate). Requires Owner permissions. Omit expires_at unless the task gives an explicit expiry date. If provided, use YYYY-MM-DD within the instance maximum token lifetime.

**Required parameters:** `group_id (string)`, `name (string)`, `scopes (array)`, `service_account_id (integer)`

### `group.service_account_pat_list` — Group Service Account Pat List

_read-only_

List the personal access tokens of one group service account. Use for GitLab group service accounts and their personal access tokens. Do not use group members, SCIM identities, enterprise users, or generic group access tokens for service account CRUD. Available on all tiers (Free, Premium, Ultimate). Requires Owner permissions.

**Required parameters:** `group_id (string)`, `service_account_id (integer)`

### `group.service_account_pat_revoke` — Group Service Account Pat Revoke

_destructive_

Revoke one of a group service account's personal access tokens. Use for GitLab group service accounts and their personal access tokens. Do not use group members, SCIM identities, enterprise users, or generic group access tokens for service account CRUD. Available on all tiers (Free, Premium, Ultimate). Requires Owner permissions.

**Required parameters:** `group_id (string)`, `service_account_id (integer)`, `token_id (integer)`

### `group.service_account_pat_rotate` — Group Service Account Pat Rotate

Rotate a group service account's personal access token: revokes the supplied token_id and issues a replacement in one step (all tiers, Owner role).
Returns: the new personal access token object (id, name, scopes, active, revoked, created_at, expires_at, and the one-time token value, which must be captured immediately because it is not retrievable later).
See also: group.service_account_pat_create, group.service_account_pat_revoke, group.service_account_pat_list.

**Required parameters:** `group_id (string)`, `service_account_id (integer)`, `token_id (integer)`

### `group.service_account_update` — Group Service Account Update

Update a group service account's name or username. Use for GitLab group service accounts and their personal access tokens. Do not use group members, SCIM identities, enterprise users, or generic group access tokens for service account CRUD. Available on all tiers (Free, Premium, Ultimate). Requires Owner permissions. Omit email unless the task gives an explicit valid email address.

**Required parameters:** `group_id (string)`, `service_account_id (integer)`

### `group.share_with_group` — Group Share With Group

Share a GitLab group with another group (Groups API). Returns: a confirmation with the granted access role. See also: group.shared_with, group.unshare_from_group, group.get.

**Required parameters:** `group_access (integer)`, `group_id (string)`, `shared_group_id (integer)`

### `group.shared_projects` — Group Shared Projects List

_read-only_

List projects shared with a GitLab group. Returns: shared projects with path, visibility, and archived status. See also: group.projects, group.shared_with, group.get.

**Required parameters:** `group_id (string)`

### `group.shared_with` — Group Shared With List

_read-only_

List groups shared with a GitLab group (group-to-group shares). Returns: the shared groups with path, visibility, and access metadata. See also: group.invited_groups, group.members, group.subgroups.

**Required parameters:** `group_id (string)`

### `group.subgroups` — Subgroups List

_read-only_

List the subgroups (descendant groups) of a GitLab group. Returns: descendant groups with path, name, and visibility. See also: group.get, group.projects, group.transfer_locations.

**Required parameters:** `group_id (string)`

### `group.transfer` — Group Transfer

Transfer a GitLab group under a new parent (or to top level). Returns: the updated group metadata. See also: group.transfer_locations, group.get, group.subgroups.

**Required parameters:** `group_id (string)`

### `group.transfer_locations` — Group Transfer Locations

_read-only_

List candidate parent groups for transferring a GitLab group. Returns: eligible destination groups with id, name, and full path. See also: group.transfer_project, group.get, group.subgroups.

**Required parameters:** `group_id (string)`

### `group.transfer_project` — Group Transfer Project

Transfer a project into a GitLab group namespace. Returns: the updated project metadata. See also: group.transfer_locations, group.get, group.projects.

**Required parameters:** `group_id (string)`, `project_id (string)`

### `group.unarchive` — Group Unarchive

Unarchive a GitLab group (restore write access). Returns: a success confirmation. See also: group.archive, group.get, group.update.

**Required parameters:** `group_id (string)`

### `group.unshare_from_group` — Group Unshare From Group

_destructive_

Revoke a group-to-group share (Groups API). Returns: a success confirmation. See also: group.share_with_group, group.shared_with, group.get.

**Required parameters:** `group_id (string)`, `shared_group_id (integer)`

### `group.update` — Group Update

Update a GitLab group's settings. Returns: the updated group metadata. See also: group.get, group.create, group.delete.

**Required parameters:** `group_id (string)`

### `group.upload_avatar` — Group Upload Avatar

Upload or replace a GitLab group's avatar image. Returns: the updated group metadata. See also: group.update, group.get, group.create.

**Required parameters:** `filename (string)`, `group_id (string)`