# snippet — gitlab

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

Canonical: https://mcp.jmrp.io/servers/gitlab/actions/snippet/
Language: en
Alternate: https://mcp.jmrp.io/es/servers/gitlab/actions/snippet/index.md
Updated: 2026-09-22T21:41:36+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 765 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

### `snippet.content` — Snippet Content

_read-only_

Read a personal snippet's raw content. Returns: the snippet ID and raw text content. See also: snippet.get, snippet.file_content.

**Required parameters:** `snippet_id (integer)`

### `snippet.create` — Snippet Create

Create a personal snippet. Returns: the created snippet with ID, visibility, author, files, and web URL. See also: snippet.get, snippet.update, snippet.list.

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

**At least one of:** `file_name (string)` + `content (string)` or `files (array)`

### `snippet.delete` — Snippet Delete

_destructive_

Delete a personal snippet permanently. Returns: a success confirmation. See also: snippet.get, snippet.list.

**Required parameters:** `snippet_id (integer)`

### `snippet.discussion_add_note` — Add Snippet Discussion Note

Add a reply note to an existing snippet discussion thread. Returns: the created note (author, body, timestamps). See also: snippet.discussion_create, snippet.discussion_get, snippet.discussion_update_note.

**Required parameters:** `body (string)`, `discussion_id (string)`, `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.discussion_create` — Create Snippet Discussion

Create a new discussion thread on a project snippet with an initial note. Returns: the created thread with its first note. See also: snippet.discussion_add_note, snippet.discussion_list, snippet.note_create.

**Required parameters:** `body (string)`, `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.discussion_delete_note` — Delete Snippet Discussion Note

_destructive_

Delete a note from a snippet discussion thread (destructive). Returns: a deletion confirmation message. See also: snippet.discussion_update_note, snippet.discussion_get, snippet.discussion_list.

**Required parameters:** `discussion_id (string)`, `note_id (integer)`, `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.discussion_get` — Get Snippet Discussion

_read-only_

Get a single snippet discussion thread by its discussion id. Returns: the thread with every note (author, body, system flag, resolvable/resolved state). See also: snippet.discussion_list, snippet.discussion_add_note, snippet.project_get.

**Required parameters:** `discussion_id (string)`, `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.discussion_list` — List Snippet Discussions

_read-only_

List discussion threads on a project snippet with ordering and keyset pagination. Returns: discussion threads with their notes (author, body, system flag, resolvable state) and pagination metadata. See also: snippet.discussion_get, snippet.discussion_create, snippet.project_get, snippet.note_list.

**Required parameters:** `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.discussion_update_note` — Update Snippet Discussion Note

Update the body of a note in a snippet discussion thread. Returns: the updated note. See also: snippet.discussion_add_note, snippet.discussion_delete_note, snippet.discussion_get.

**Required parameters:** `body (string)`, `discussion_id (string)`, `note_id (integer)`, `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.emoji_snippet_create` — Snippet Emoji Create

Add an emoji reaction to a project snippet. Returns: the created award with its emoji name, awarding user object, timestamps, and awardable id/type. See also: snippet.emoji_snippet_list, snippet.emoji_snippet_delete.

**Required parameters:** `name (string)`, `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.emoji_snippet_delete` — Snippet Emoji Delete

_destructive_

Remove an emoji reaction from a project snippet by award id. Returns: a success confirmation naming the award emoji. See also: snippet.emoji_snippet_list, snippet.emoji_snippet_get.

**Required parameters:** `award_id (integer)`, `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.emoji_snippet_get` — Snippet Emoji Get

_read-only_

Get a single emoji reaction on a project snippet by award id. Returns: the award with its emoji name, awarding user object, timestamps, and awardable id/type. See also: snippet.emoji_snippet_list, snippet.emoji_snippet_delete.

**Required parameters:** `award_id (integer)`, `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.emoji_snippet_list` — Snippet Emoji List

_read-only_

List all emoji reactions on a project snippet. Returns: each award with its emoji name, the awarding user object, awardable id/type, and pagination metadata. See also: snippet.emoji_snippet_get, snippet.emoji_snippet_create, snippet.project_get.

**Required parameters:** `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.emoji_snippet_note_create` — Snippet Note Emoji Create

Add an emoji reaction to a project snippet note. Returns: the created award with its emoji name, awarding user object, timestamps, and awardable id/type. See also: snippet.emoji_snippet_note_list, snippet.emoji_snippet_note_delete.

**Required parameters:** `name (string)`, `note_id (integer)`, `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.emoji_snippet_note_delete` — Snippet Note Emoji Delete

_destructive_

Remove an emoji reaction from a project snippet note by award id. Returns: a success confirmation naming the award emoji. See also: snippet.emoji_snippet_note_list, snippet.emoji_snippet_note_get.

**Required parameters:** `award_id (integer)`, `note_id (integer)`, `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.emoji_snippet_note_get` — Snippet Note Emoji Get

_read-only_

Get a single emoji reaction on a project snippet note by award id. Returns: the award with its emoji name, awarding user object, timestamps, and awardable id/type. See also: snippet.emoji_snippet_note_list, snippet.emoji_snippet_note_delete.

**Required parameters:** `award_id (integer)`, `note_id (integer)`, `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.emoji_snippet_note_list` — Snippet Note Emoji List

_read-only_

List all emoji reactions on a project snippet note (comment). Returns: each award with its emoji name, the awarding user object, awardable id/type, and pagination metadata. See also: snippet.emoji_snippet_note_get, snippet.emoji_snippet_note_create, snippet.note_get.

**Required parameters:** `note_id (integer)`, `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.explore` — Snippet Explore

_read-only_

List public snippets across the instance. Returns: public snippets with author, visibility, and pagination metadata. See also: snippet.list, snippet.get.

### `snippet.file_content` — Snippet File Content

_read-only_

Read one file from a multi-file personal snippet at a ref. Returns: the snippet ID, ref, file name, and raw content. See also: snippet.content, snippet.get.

**Required parameters:** `file_name (string)`, `ref (string)`, `snippet_id (integer)`

### `snippet.get` — Snippet Get

_read-only_

Get a single personal snippet by ID. Returns: snippet metadata, visibility, author, files, and web URL. See also: snippet.list, snippet.content, snippet.update, snippet.delete.

**Required parameters:** `snippet_id (integer)`

### `snippet.list` — Snippet List

_read-only_

List snippets owned by the authenticated user. Returns: snippets with title, visibility, author, files, and pagination metadata. See also: snippet.get, snippet.create, snippet.explore.

### `snippet.list_all` — Snippet List All

_read-only_

List all snippets on the instance (admin). Returns: snippets with author, visibility, repository storage, and pagination metadata. See also: snippet.list, snippet.explore, snippet.get.

### `snippet.note_create` — Snippet Note Create

Add a comment (note) to a project snippet. Returns: the created note with id, author, body, and timestamps. See also: snippet.note_list, snippet.note_get, snippet.project_get.

**Required parameters:** `body (string)`, `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.note_delete` — Snippet Note Delete

_destructive_

Delete a snippet note permanently. Returns: a success confirmation naming the note, snippet, and project. See also: snippet.note_get, snippet.note_list.

**Required parameters:** `note_id (integer)`, `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.note_get` — Snippet Note Get

_read-only_

Get a single snippet note by its ID. Returns: the note with author, body, timestamps, and position. See also: snippet.note_list, snippet.note_update, snippet.note_delete.

**Required parameters:** `note_id (integer)`, `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.note_list` — Snippet Note List

_read-only_

List all notes (comments) on a project snippet. Returns: notes with author, body, system flag, and pagination metadata. See also: snippet.note_get, snippet.note_create, snippet.project_get.

**Required parameters:** `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.note_update` — Snippet Note Update

Update a snippet note's body. Returns: the updated note with new body and updated_at timestamp. See also: snippet.note_get, snippet.note_list, snippet.note_delete.

**Required parameters:** `body (string)`, `note_id (integer)`, `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.project_content` — Project Snippet Content

_read-only_

Read a project snippet's raw content. Returns: the snippet ID and raw text content. See also: snippet.project_get, snippet.project_list.

**Required parameters:** `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.project_create` — Project Snippet Create

Create a project snippet. Returns: the created snippet with ID, visibility, author, files, and web URL. See also: snippet.project_get, snippet.project_update, snippet.project_list.

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

**At least one of:** `file_name (string)` + `content (string)` or `files (array)`

### `snippet.project_delete` — Project Snippet Delete

_destructive_

Delete a project snippet permanently. Returns: a success confirmation. See also: snippet.project_get, snippet.project_list.

**Required parameters:** `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.project_get` — Project Snippet Get

_read-only_

Get a single project snippet. Returns: snippet metadata, visibility, author, files, and web URL. See also: snippet.project_list, snippet.project_content, snippet.project_update, snippet.project_delete.

**Required parameters:** `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.project_list` — Project Snippet List

_read-only_

List a project's snippets. Returns: snippets with title, visibility, author, files, and pagination metadata. See also: snippet.project_get, snippet.project_create, snippet.list.

**Required parameters:** `project_id (string|integer)`

### `snippet.project_update` — Project Snippet Update

Update a project snippet. Returns: the updated snippet with metadata, files, and web URL. See also: snippet.project_get, snippet.project_delete, snippet.project_list.

**Required parameters:** `project_id (string|integer)`, `snippet_id (integer)`

### `snippet.update` — Snippet Update

Update a personal snippet. Returns: the updated snippet with metadata, files, and web URL. See also: snippet.get, snippet.delete, snippet.list.

**Required parameters:** `snippet_id (integer)`