---
title: "Labels & comments tools in the Speak AI MCP"
description: "Manage workspace labels, apply them to transcript words, and discuss a file in comment threads. All 16 Labels & comments tools, with parameters and behaviour hints."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.speakai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Labels & comments tools in the Speak AI MCP

The Labels & comments category groups 16 of the Speak AI MCP server's tools. Manage
workspace labels, apply them to transcript words, and discuss a file in comment
threads.

## Which Labels & comments tools does the Speak AI MCP server have?

The Speak AI MCP server has 16 Labels & comments tools. Each one has its own page
with a plain-language summary, its parameters, and its behaviour hints.

- [`list_labels`](/mcp/tools/labels-comments/list_labels/): List the workspace's
  labels as a tree: groups (isGroup true) carry their labels in `labels`, and
  ungrouped labels sit at the top level.
- [`create_label`](/mcp/tools/labels-comments/create_label/): Create a label, or a
  label group with isGroup true.
- [`update_label`](/mcp/tools/labels-comments/update_label/): Rename, recolor,
  describe, move or reorder a label or group.
- [`archive_label`](/mcp/tools/labels-comments/archive_label/): Archive a label so
  it can no longer be applied; archiving a group archives its labels too.
- [`restore_label`](/mcp/tools/labels-comments/restore_label/): Restore an archived
  label; restoring a group also restores its archived labels.
- [`merge_labels`](/mcp/tools/labels-comments/merge_labels/): Merge one label into
  another: every place the source label is applied moves onto the target (a span
  that had both keeps one), then the source is archived with mergedInto set.
- [`add_speak_label_sets`](/mcp/tools/labels-comments/add_speak_label_sets/): Add
  ready-made label groups from Speak: sales_qa (Unprofessional, Slang, Objection,
  Great moment, Compliance risk), research (Pain point, Motivation, Quote for
  report, Surprise, Follow-up), meetings (Decision, Action item, Risk, Open
  question) and transcript_feedback (Wrong split, Misheard word, Wrong speaker, Bad
  translation).
- [`list_media_labels`](/mcp/tools/labels-comments/list_media_labels/): List the
  labels applied to a media file's transcript, in transcript order, with the file's
  current transcriptRevision.
- [`apply_label`](/mcp/tools/labels-comments/apply_label/): Apply one or more labels
  to a span of words in a media file's transcript.
- [`update_media_label`](/mcp/tools/labels-comments/update_media_label/): Change a
  labelled span on a transcript.
- [`remove_media_label`](/mcp/tools/labels-comments/remove_media_label/): Remove a
  labelled span from a transcript.
- [`list_media_comments`](/mcp/tools/labels-comments/list_media_comments/): List the
  comment threads on a media file, with the file's current transcriptRevision.
- [`add_comment`](/mcp/tools/labels-comments/add_comment/): Add a comment to a media
  file.
- [`update_comment`](/mcp/tools/labels-comments/update_comment/): Edit the text of a
  comment.
- [`resolve_comment`](/mcp/tools/labels-comments/resolve_comment/): Resolve a
  comment thread, or reopen it with resolved false.
- [`delete_comment`](/mcp/tools/labels-comments/delete_comment/): Delete a comment.

## Related

- [Tool reference](/mcp/tools/) lists every Speak AI MCP server tool across every
  category.
- [MCP server](/mcp/) covers setup, supported clients, and what agents can do once
  connected.

Source: https://docs.speakai.co/mcp/tools/labels-comments/index.mdx