# issue — gitlab > 66 actions > This page as plain markdown. Index: https://mcp.jmrp.io/llms.txt Canonical: https://mcp.jmrp.io/servers/gitlab/actions/issue/ Language: en Alternate: https://mcp.jmrp.io/es/servers/gitlab/actions/issue/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 ### `issue.create` — Issue Create Create a new issue in a project. Returns: the created issue with IID, state, labels, assignees, milestone, due date, and web URL. See also: issue.get, issue.list, issue.update. **Required parameters:** `project_id (string)`, `title (string)` ### `issue.create_todo` — Issue Create Todo Create a to-do for an issue. Returns: the created to-do item with action, target, and state. See also: issue.get. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.delete` — Issue Delete _destructive_ Delete an issue permanently. Returns: a success confirmation naming the issue and project. See also: issue.get, issue.update. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.discussion_add_note` — Add Issue Discussion Note Add a reply note to an existing issue discussion thread. Returns: the created note (author, body, timestamps). See also: issue.discussion_create, issue.discussion_get, issue.discussion_update_note. **Required parameters:** `body (string)`, `discussion_id (string)`, `issue_iid (integer)`, `project_id (string)` ### `issue.discussion_create` — Create Issue Discussion Create a new discussion thread on an issue with an initial note. Returns: the created thread with its first note. See also: issue.discussion_add_note, issue.discussion_list, issue.note_create. **Required parameters:** `body (string)`, `issue_iid (integer)`, `project_id (string)` ### `issue.discussion_delete_note` — Delete Issue Discussion Note _destructive_ Delete a note from an issue discussion thread (destructive). Returns: a deletion confirmation message. See also: issue.discussion_update_note, issue.discussion_get, issue.discussion_list. **Required parameters:** `discussion_id (string)`, `issue_iid (integer)`, `note_id (integer)`, `project_id (string)` ### `issue.discussion_get` — Get Issue Discussion _read-only_ Get a single issue discussion thread by its discussion id. Returns: the thread with every note (author, body, system flag, resolvable/resolved state). See also: issue.discussion_list, issue.discussion_add_note, issue.get. **Required parameters:** `discussion_id (string)`, `issue_iid (integer)`, `project_id (string)` ### `issue.discussion_list` — List Issue Discussions _read-only_ List discussion threads on an issue with ordering and keyset pagination. Returns: discussion threads with their notes (author, body, system flag, resolvable state) and pagination metadata. See also: issue.discussion_get, issue.discussion_create, issue.get, issue.note_list. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.discussion_update_note` — Update Issue Discussion Note Update the body of a note in an issue discussion thread. Returns: the updated note. See also: issue.discussion_add_note, issue.discussion_delete_note, issue.discussion_get. **Required parameters:** `body (string)`, `discussion_id (string)`, `issue_iid (integer)`, `note_id (integer)`, `project_id (string)` ### `issue.emoji_issue_create` — Issue Emoji Create Add an emoji reaction to an issue. Returns: the created award with its emoji name, awarding user object, timestamps, and awardable id/type. See also: issue.emoji_issue_list, issue.emoji_issue_delete. **Required parameters:** `issue_iid (integer)`, `name (string)`, `project_id (string)` ### `issue.emoji_issue_delete` — Issue Emoji Delete _destructive_ Remove an emoji reaction from an issue by award id. Returns: a success confirmation naming the award emoji. See also: issue.emoji_issue_list, issue.emoji_issue_get. **Required parameters:** `award_id (integer)`, `issue_iid (integer)`, `project_id (string)` ### `issue.emoji_issue_get` — Issue Emoji Get _read-only_ Get a single emoji reaction on an issue by award id. Returns: the award with its emoji name, awarding user object, timestamps, and awardable id/type. See also: issue.emoji_issue_list, issue.emoji_issue_delete. **Required parameters:** `award_id (integer)`, `issue_iid (integer)`, `project_id (string)` ### `issue.emoji_issue_list` — Issue Emoji List _read-only_ List all emoji reactions on an issue. Returns: each award with its emoji name, the awarding user object, awardable id/type, and pagination metadata. See also: issue.emoji_issue_get, issue.emoji_issue_create, issue.get. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.emoji_issue_note_create` — Issue Note Emoji Create Add an emoji reaction to an issue note. Returns: the created award with its emoji name, awarding user object, timestamps, and awardable id/type. See also: issue.emoji_issue_note_list, issue.emoji_issue_note_delete. **Required parameters:** `issue_iid (integer)`, `name (string)`, `note_id (integer)`, `project_id (string)` ### `issue.emoji_issue_note_delete` — Issue Note Emoji Delete _destructive_ Remove an emoji reaction from an issue note by award id. Returns: a success confirmation naming the award emoji. See also: issue.emoji_issue_note_list, issue.emoji_issue_note_get. **Required parameters:** `award_id (integer)`, `issue_iid (integer)`, `note_id (integer)`, `project_id (string)` ### `issue.emoji_issue_note_get` — Issue Note Emoji Get _read-only_ Get a single emoji reaction on an issue note by award id. Returns: the award with its emoji name, awarding user object, timestamps, and awardable id/type. See also: issue.emoji_issue_note_list, issue.emoji_issue_note_delete. **Required parameters:** `award_id (integer)`, `issue_iid (integer)`, `note_id (integer)`, `project_id (string)` ### `issue.emoji_issue_note_list` — Issue Note Emoji List _read-only_ List all emoji reactions on an issue note (comment). Returns: each award with its emoji name, the awarding user object, awardable id/type, and pagination metadata. See also: issue.emoji_issue_note_get, issue.emoji_issue_note_create, issue.note_get. **Required parameters:** `issue_iid (integer)`, `note_id (integer)`, `project_id (string)` ### `issue.event_issue_label_get` — Issue Label Event Get _read-only_ Get a single label event for an issue. Returns: the event with action, the label object, and the acting user. See also: issue.event_issue_label_list. **Required parameters:** `issue_iid (integer)`, `label_event_id (integer)`, `project_id (string)` ### `issue.event_issue_label_list` — Issue Label Event List _read-only_ List label events for an issue. Returns: label events with action, the label object, the acting user, and pagination metadata. See also: issue.event_issue_label_get, issue.get. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.event_issue_milestone_get` — Issue Milestone Event Get _read-only_ Get a single milestone event for an issue. Returns: the event with action, the milestone object, and the acting user. See also: issue.event_issue_milestone_list. **Required parameters:** `issue_iid (integer)`, `milestone_event_id (integer)`, `project_id (string)` ### `issue.event_issue_milestone_list` — Issue Milestone Event List _read-only_ List milestone events for an issue. Returns: milestone events with action, the milestone object, the acting user, and pagination metadata. See also: issue.event_issue_milestone_get, issue.get. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.event_issue_state_get` — Issue State Event Get _read-only_ Get a single state event for an issue. Returns: the event with the state value and the acting user. See also: issue.event_issue_state_list. **Required parameters:** `issue_iid (integer)`, `project_id (string)`, `state_event_id (integer)` ### `issue.event_issue_state_list` — Issue State Event List _read-only_ List state events for an issue. Returns: state events with the state value, the acting user, and pagination metadata. See also: issue.event_issue_state_get, issue.get. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.get` — Issue Get _read-only_ Get a single issue from a project by issue IID. Returns: issue metadata, state, labels, assignees, author, due date, task completion, and web URL. See also: issue.list, issue.update, issue.delete, issue.note_list. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.get_by_id` — Issue Get By ID _read-only_ Get a single issue by its global ID. Returns: the issue with state, labels, assignees, author, and web URL. See also: issue.get, issue.list. **Required parameters:** `issue_id (integer)` ### `issue.link_create` — Issue Link Create Create a link between two issues (optionally across projects). Returns: the created link with its id, link_type, and source_issue/target_issue objects. See also: issue.link_list, issue.link_delete, issue.get. **Required parameters:** `issue_iid (integer)`, `project_id (string)`, `target_issue_iid (string)`, `target_project_id (string)` ### `issue.link_delete` — Issue Link Delete _destructive_ Remove an existing issue link by its issue_link_id. Returns: a deletion confirmation. See also: issue.link_list, issue.link_create, issue.get. **Required parameters:** `issue_iid (integer)`, `issue_link_id (integer)`, `project_id (string)` ### `issue.link_get` — Issue Link Get _read-only_ Get one issue link by its issue_link_id. Returns: the link's id, link_type, and full source_issue/target_issue objects. See also: issue.link_list, issue.link_create, issue.get. **Required parameters:** `issue_iid (integer)`, `issue_link_id (integer)`, `project_id (string)` ### `issue.link_list` — Issue Link List _read-only_ List all issues linked to a source issue. Returns: each linked issue with its link_type, issue_link_id, full author/assignee/milestone objects, labels, and dates. See also: issue.link_get, issue.link_create, issue.get. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.list` — Issue List _read-only_ List issues in one project with filtering and pagination. Returns: matching issues with state, labels, assignees, author, and pagination metadata. See also: issue.get, issue.create, search.issues. **Required parameters:** `project_id (string)` ### `issue.list_all` — Issue List All _read-only_ List issues across accessible projects. Returns: visible issues with project context and pagination metadata. See also: issue.list, issue.list_group, search.issues. ### `issue.list_group` — Issue List Group _read-only_ List issues across a group and its subgroups and projects. Use when work is scoped to a group rather than a single project. **Required parameters:** `group_id (string)` **alias of:** `group.issues` (group) ### `issue.move` — Issue Move Move an issue to another project. Returns: the issue in its new project. See also: issue.get, issue.update. **Required parameters:** `issue_iid (integer)`, `project_id (string)`, `to_project_id (integer)` ### `issue.mrs_closing` — Issue MRs Closing _read-only_ List MRs that close this issue on merge. Returns: related merge requests with state, author, and branches. See also: issue.get, issue.mrs_related. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.mrs_related` — Issue MRs Related _read-only_ List MRs related to this issue. Returns: related merge requests with state, author, and branches. See also: issue.get, issue.mrs_closing. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.note_create` — Issue Note Create Add a comment (note) to an issue. Returns: the created note with id, author, body, timestamps, and resolvable/internal flags. See also: issue.note_list, issue.get, issue.discussion_create. **Required parameters:** `body (string)`, `issue_iid (integer)`, `project_id (string)` ### `issue.note_delete` — Issue Note Delete _destructive_ Delete an issue note permanently. Returns: a success confirmation naming the note, issue, and project. See also: issue.note_get, issue.note_list. **Required parameters:** `issue_iid (integer)`, `note_id (integer)`, `project_id (string)` ### `issue.note_get` — Issue Note Get _read-only_ Get a single issue note by its ID. Returns: the note with author, body, timestamps, position, and resolvable/internal flags. See also: issue.note_list, issue.note_update, issue.note_delete. **Required parameters:** `issue_iid (integer)`, `note_id (integer)`, `project_id (string)` ### `issue.note_list` — Issue Note List _read-only_ List all notes (comments) on an issue. Returns: notes with author, body, system/internal flags, and pagination metadata. See also: issue.note_get, issue.note_create, issue.discussion_get. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.note_update` — Issue Note Update Update an issue note's body. Returns: the updated note with new body and updated_at timestamp. See also: issue.note_get, issue.note_list, issue.note_delete. **Required parameters:** `body (string)`, `issue_iid (integer)`, `note_id (integer)`, `project_id (string)` ### `issue.participants` — Issue Participants _read-only_ List an issue's participants. Returns: participating users with username and name. See also: issue.get, issue.note_list. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.reorder` — Issue Reorder Reorder an issue within its list. Returns: the updated issue. See also: issue.get, issue.list. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.spent_time_add` — Issue Spent Time Add Add spent time to an issue. Returns: the updated time tracking stats. See also: issue.spent_time_reset, issue.time_stats_get. **Required parameters:** `duration (string)`, `issue_iid (integer)`, `project_id (string)` ### `issue.spent_time_reset` — Issue Spent Time Reset Reset an issue's spent time. Returns: the updated time tracking stats. See also: issue.spent_time_add, issue.time_stats_get. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.statistics_get` — Get Issue Statistics _read-only_ Get global issue count statistics across all visible projects. Returns: a statistics object with nested counts (all, opened, closed). See also: issue.statistics_get_group, issue.statistics_get_project, issue.list. ### `issue.statistics_get_group` — Get Group Issue Statistics _read-only_ Get issue count statistics for a group and its descendant projects. Returns: a statistics object with nested counts (all, opened, closed). See also: issue.statistics_get, issue.statistics_get_project, group.get. **Required parameters:** `group_id (string)` ### `issue.statistics_get_project` — Get Project Issue Statistics _read-only_ Get issue count statistics for a single project. Returns: a statistics object with nested counts (all, opened, closed). See also: issue.statistics_get, issue.statistics_get_group, project.get. **Required parameters:** `project_id (string)` ### `issue.subscribe` — Issue Subscribe Subscribe to an issue's notifications. Returns: the issue with the updated subscription state. See also: issue.get, issue.unsubscribe. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.time_estimate_reset` — Issue Time Estimate Reset Clear an issue's time estimate. Returns: the updated time tracking stats. See also: issue.time_estimate_set, issue.time_stats_get. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.time_estimate_set` — Issue Time Estimate Set Set an issue's time estimate. Returns: the updated time tracking stats. See also: issue.time_estimate_reset, issue.time_stats_get. **Required parameters:** `duration (string)`, `issue_iid (integer)`, `project_id (string)` ### `issue.time_stats_get` — Issue Time Stats Get _read-only_ Read an issue's time tracking totals. Returns: estimate and spent time in seconds and human-readable form. See also: issue.time_estimate_set, issue.spent_time_add. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.unsubscribe` — Issue Unsubscribe Unsubscribe from an issue's notifications. Returns: the issue with the updated subscription state. See also: issue.get, issue.subscribe. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.update` — Issue Update Update issue fields. To close or reopen an issue with issue.update, set params.state_event to close or reopen. Dynamic execute also accepts issue.close and issue.reopen aliases that fill state_event automatically. **Required parameters:** `issue_iid (integer)`, `project_id (string)` ### `issue.work_item_create` — Create Work Item Create a new work item under a namespace. Returns: the created work item with id, iid, type, state, title, description, assignees, labels, linked items, parent and child work items, milestone, iteration, weight, health status, color, start and due dates, and web URL. Experimental. See also: issue.work_item_get, issue.work_item_list, issue.work_item_type_list. **Required parameters:** `full_path (string)`, `title (string)`, `work_item_type_id (string)` ### `issue.work_item_delete` — Delete Work Item _destructive_ Delete a work item permanently by namespace path and IID. Returns: a success confirmation naming the work item and namespace. Experimental. See also: issue.work_item_get, issue.work_item_update. **Required parameters:** `full_path (string)`, `work_item_iid (integer)` ### `issue.work_item_get` — Get Work Item _read-only_ Get a single work item by namespace path and IID. Returns: id, iid, type, state, status, title, description, author, assignees, labels, linked items, parent and child work items, milestone, iteration, weight, health status, color, start and due dates, confidentiality, timestamps, and web URL. Experimental. See also: issue.work_item_list, issue.work_item_update, issue.work_item_delete. **Required parameters:** `full_path (string)`, `work_item_iid (integer)` ### `issue.work_item_list` — List Work Items _read-only_ List work items in a project or group namespace with filtering and cursor pagination. Returns: matching work items with type, state, title, author, assignees, labels, linked items, parent and child work items, milestone, start and due dates, timestamps, and the cursors for the next and previous pages. On Premium and Ultimate instances the status, weight, health status, iteration and color of each item come back too. returned_fields narrows that set to the fields named, which shrinks a large page without changing which work items match. Pages in both directions: first with after walks forward, last with before walks back. Experimental. See also: issue.work_item_get, issue.work_item_create, issue.work_item_type_list. **Required parameters:** `full_path (string)` ### `issue.work_item_saved_view_create` — Work Item Saved View Create Create a work item saved view under a namespace. Returns: the created view with id, global id, name, private flag, subscription state, sort order, filters, and display settings. Experimental: the Work Item Saved Views API is a work in progress and may introduce breaking changes even between minor versions. See also: issue.work_item_saved_view_list, issue.work_item_saved_view_update, issue.work_item_saved_view_get. **Required parameters:** `name (string)`, `namespace_path (string)`, `sort (string)` ### `issue.work_item_saved_view_delete` — Work Item Saved View Delete _destructive_ Delete a work item saved view permanently by numeric ID. Returns: a success confirmation naming the view. Experimental: the Work Item Saved Views API is a work in progress and may introduce breaking changes even between minor versions. See also: issue.work_item_saved_view_get, issue.work_item_saved_view_list. **Required parameters:** `saved_view_id (integer)` ### `issue.work_item_saved_view_get` — Work Item Saved View Get _read-only_ Get a single work item saved view by namespace path and numeric ID. Returns: id, global id, name, description, private flag, subscription state, sort order, filters, and display settings. Experimental: the Work Item Saved Views API is a work in progress and may introduce breaking changes even between minor versions. See also: issue.work_item_saved_view_list, issue.work_item_saved_view_update, issue.work_item_saved_view_delete. **Required parameters:** `namespace_path (string)`, `saved_view_id (integer)` ### `issue.work_item_saved_view_list` — Work Item Saved View List _read-only_ List work item saved views for a group or project namespace with cursor pagination. Returns: id, name, description, private flag, subscription state, and sort order per view, plus pagination cursors. Filters are omitted here, so read one view with gitlab_work_item_saved_view_get. Experimental: the Work Item Saved Views API is a work in progress and may introduce breaking changes even between minor versions. See also: issue.work_item_saved_view_get, issue.work_item_saved_view_create, issue.work_item_list. **Required parameters:** `namespace_path (string)` ### `issue.work_item_saved_view_subscribe` — Work Item Saved View Subscribe Subscribe the authenticated user to a work item saved view. Returns: the view with the updated subscription state. Experimental: the Work Item Saved Views API is a work in progress and may introduce breaking changes even between minor versions. See also: issue.work_item_saved_view_unsubscribe, issue.work_item_saved_view_get, issue.work_item_saved_view_list. **Required parameters:** `saved_view_id (integer)` ### `issue.work_item_saved_view_unsubscribe` — Work Item Saved View Unsubscribe Unsubscribe the authenticated user from a work item saved view. Returns: the view with the updated subscription state. Experimental: the Work Item Saved Views API is a work in progress and may introduce breaking changes even between minor versions. See also: issue.work_item_saved_view_subscribe, issue.work_item_saved_view_get, issue.work_item_saved_view_list. **Required parameters:** `saved_view_id (integer)` ### `issue.work_item_saved_view_update` — Work Item Saved View Update Update a work item saved view by numeric ID. Returns: the updated view with id, global id, name, private flag, subscription state, sort order, filters, and display settings. Experimental: the Work Item Saved Views API is a work in progress and may introduce breaking changes even between minor versions. See also: issue.work_item_saved_view_get, issue.work_item_saved_view_list, issue.work_item_saved_view_delete. **Required parameters:** `saved_view_id (integer)` ### `issue.work_item_type_list` — List Work Item Types _read-only_ List work item types for a namespace. Returns: id, name, and enabled flag for each type. Supports name filter, only_available flag, and cursor pagination. Experimental. See also: issue.work_item_list, issue.work_item_create. **Required parameters:** `full_path (string)` ### `issue.work_item_update` — Update Work Item Update an existing work item by namespace path and IID. Returns: the updated work item with id, iid, type, state, status, title, description, assignees, labels, linked items, parent and child work items, milestone, iteration, weight, health status, color, start and due dates, and web URL. Experimental. See also: issue.work_item_get, issue.work_item_delete, issue.work_item_list. **Required parameters:** `full_path (string)`, `work_item_iid (integer)`