Work IQ Word reference (preview)

Important

This is a preview feature.

  • Microsoft releases preview features before an official release so that customers can get early access and provide feedback.
  • Preview features have restricted functionality and aren't meant for production use.
  • Microsoft might change preview MCP tool names and parameters. Avoid hard-coded dependencies. Microsoft maintains scenario support.
  • Preview features are subject to Microsoft supplemental terms of use.

Overview

Server ID Tenant-level URL Display name Description
mcp_WordServer https://agent365.svc.cloud.microsoft/
agents/tenants/{tenantId}/
servers/mcp_WordServer		 Work IQ Word MCP server containing tools to work with Microsoft Word documents

Available tools

WordCreateNewDocument

Creates a new Word document in the root of the user's OneDrive. Provide a desired file name (can be empty) and HTML or plain text content to populate the document body. If fileName is empty, a name like Document_yyyyMMdd_HHmms.docx is generated. Returns the created DriveItem JSON from Microsoft Graph.

Required parameters:

  • fileName: Desired file name (can be empty for autogenerated name)
  • contentInHtml: HTML or plain text content for document body

WordGetDocumentContent

Fetches the raw Word document (DOCX) content from OneDrive or SharePoint given its SharePoint sharing URL. Returns a JSON payload with filename, size, driveId, documentId, plain text content, and all comments in that document. Input must be the sharing link (SharePoint or OneDrive URL).

Required parameters:

  • url: SharePoint or OneDrive sharing URL of the document

WordCreateNewComment

Adds a new comment in the Word document. Provide driveId, documentId, and the comment text.

Required parameters:

  • driveId: Drive ID of the document
  • documentId: Document ID
  • newComment: Comment text to add

WordReplyToComment

Replies to a comment in the Word document. Provide commentId, driveId, documentId, and the reply text.

Required parameters:

  • commentId: ID of the comment to reply to
  • driveId: Drive ID of the document
  • documentId: Document ID
  • newComment: Reply text

Key Features

Document creation

  • Create Word documents directly in OneDrive.
  • Support for HTML and plain text content.
  • Autogenerated file names with timestamp.
  • Returns Microsoft Graph DriveItem metadata.

Document retrieval

  • Fetch document content by using SharePoint or OneDrive URLs.
  • Extract plain text content from DOCX files.
  • Retrieve all document comments.
  • Get document metadata, such as file name, size, and IDs.

Comment management

  • Add new comments to documents.
  • Reply to existing comments.
  • Full comment thread support.

Notes

  • Create documents in the root of the user's OneDrive.
  • Retrieve documents by using SharePoint or OneDrive sharing URLs.
  • Perform comment operations by using driveId and documentId from document retrieval.
  • Support HTML content for rich document formatting.
  • Use autogenerated file names that follow this format: Document_yyyyMMdd_HHmms.docx.
  • Last updated on