Word reference (preview)

Note

Features in this article are powered by the standard harness, which uses the billing options described in Licensing for agents powered by the standard harness. Learn how to access standard features in Access standard agents and agent flows.

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		 Word 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