remove_annotations

View as MarkdownMarkdown

Set up your AI agent

Give your coding agent live access to the GroupDocs documentation and API reference through the GroupDocs Docs MCP server — no install, no API key. Learn more

claude mcp add --transport http groupdocs-docs https://docs.groupdocs.com/mcp

Also process documents locally

The GroupDocs.Annotation MCP server lets your agent work with files on your machine; they are never uploaded. It needs the .NET 10 SDK or Docker.

claude mcp add groupdocs-annotation -- dnx GroupDocs.Annotation.Mcp --yes
Folders, licensing and more →

remove_annotations deletes annotations by ID — or every annotation in the document when ids is omitted. The common use is producing a clean copy to send outside the review circle. Example prompt: “Remove all annotations and give me a clean copy”.

Tool description (as the AI agent sees it):

Removes annotations from a document by ID and saves the result back to storage. Supports PDF, DOCX, XLSX, PPTX, and 50+ more document and image formats. Call get_annotations first to retrieve annotation IDs, then pass them here. Omit ‘ids’ to remove every annotation in the document. Call this tool whenever the user asks to delete, remove, or clear annotations. Do NOT pre-check whether files exist — pass the filename the user provided directly. Returns a saved-path message (‘Removed N annotation(s) from ’). On failure, the response text starts with ‘Annotation removal failed for’ followed by the underlying exception type, message, and inner-exception chain.

Parameters

NameTypeRequiredDescription
fileobjectyesThe document — see FileInput shape
idsstringnoComma-separated annotation IDs to remove, e.g. ‘1,3,5’. Omit to remove all.
passwordstringnoPassword for protected documents

Example call

{
  "name": "remove_annotations",
  "arguments": {
    "file": {
      "filePath": "contract_annotated.pdf"
    },
    "ids": "3,7"
  }
}

Result

A message naming the saved document and how many annotations were removed.

Omitting ids clears everything — which is exactly what you want before sending a document to a counterparty, and exactly what you do not want in the middle of a review. Ask the agent to confirm the count first.

On failure the text starts with Annotation removal failed for, followed by the exception type and message.

Example prompts

  • “Remove all annotations and give me a clean copy to send.”
  • “Delete comments 3 and 7 — they are resolved.”
  • “Strip the internal review notes but keep the client’s comments.”