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.