Back to MCP Servers

Microsoft Word MCP Server

Official Microsoft Agent 365 MCP server (Work IQ Word) for creating Word documents in OneDrive, reading DOCX content, and managing comments.

Collaboration by Microsoft OAuth2 active
Overview

Work IQ Word is Microsoft's official, remote-hosted MCP server (server ID mcp_WordServer) that lets AI agents create and read Microsoft Word documents stored in OneDrive and SharePoint, and collaborate through comments. It is part of the Microsoft Agent 365 Work IQ tooling catalog, which exposes deterministic, governed tools across Microsoft 365 workloads including Outlook, Teams, SharePoint, OneDrive, and Word.

The server is hosted by Microsoft at the Agent 365 endpoint (agent365.svc.cloud.microsoft) and requires a Microsoft 365 Copilot license plus a Microsoft Entra enterprise application registration to authenticate. It currently exposes four tools: creating new documents from HTML or plain text, fetching document content and existing comments from a SharePoint or OneDrive sharing URL, adding new comments, and replying to existing comments.

Work IQ Word is currently in preview. Because it runs inside the Agent 365 control plane, every tool call is subject to centralized governance in the Microsoft 365 admin center, scoped permissions via Microsoft Entra, and observability through Microsoft Defender Advanced Hunting. It can be consumed from Copilot Studio, Microsoft Foundry, VS Code, GitHub Copilot CLI, and Claude Code.

Tools

Tool Description
WordCreateNewDocument Create a new Word document in the root of the user's OneDrive. Accepts HTML or plain text content. If fileName is empty, a name like Document_yyyyMMdd_HHmms.docx is generated. Returns the created DriveItem JSON from Microsoft Graph.
WordGetDocumentContent Fetch the raw Word document (DOCX) content from OneDrive or SharePoint given its sharing URL. Returns JSON with filename, size, driveId, documentId, plain text content, and all comments.
WordCreateNewComment Add a new comment to a Word document.
WordReplyToComment Reply to an existing comment in a Word document.
Setup Guide

Prerequisites

  • A Microsoft 365 Copilot license (required for all Work IQ MCP servers).
  • A Microsoft Entra tenant. Note your Tenant ID and the Application (client) ID of a registered enterprise application.
  • The application must have the WorkIQ-WordServer API permission granted and consented.
  • Add a redirect URI to the app registration under Mobile and Desktop applications, for example http://localhost:8080/callback.

Server URL

Work IQ Word is a remote MCP server hosted by Microsoft. There is no local install. Point your MCP client at:

https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_WordServer

Claude Code / GitHub Copilot CLI config

Create a .mcp.json file in your working directory. Replace {tenantId} and {clientId}:

{
  "mcpServers": {
    "WorkIQ-WordServer": {
      "type": "http",
      "url": "https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_WordServer",
      "oauth": {
        "clientId": "{clientId}",
        "callbackPort": 8080
      }
    }
  }
}

Start Claude Code (or GitHub Copilot CLI 1.0.40+) in that folder, then run /mcp to authenticate via the browser. After consent, you can call the Word tools from your agent.

VS Code config

Create mcp.json in your project folder:

{
  "WorkIQ-WordServer": {
    "type": "http",
    "url": "https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_WordServer",
    "oauth": {
      "clientId": "{clientId}"
    }
  }
}

VS Code 1.118 or later is required. Open the folder, then complete the OAuth sign-in when prompted.

Copilot Studio / Microsoft Foundry

In Copilot Studio, open your agent, go to Tools > Add Tool > Model Context Protocol, search for Work IQ Word, then create a new connection and sign in. In Microsoft Foundry, add the tool from the Microsoft provider catalog and connect using the default endpoint and auth settings.

Use Cases
  • Generate a draft Word document in a user's OneDrive from agent-produced HTML, such as meeting notes, briefs, or report templates, and return a shareable DriveItem link.
  • Read a SharePoint or OneDrive document by sharing URL to summarize, translate, or extract data from the plain text content of a DOCX file.
  • Pull all comments on a shared document so an agent can triage feedback, group similar suggestions, or produce a change list.
  • Programmatically add review comments to a colleague's document as part of an automated review or QA workflow.
  • Reply to existing comment threads on behalf of the user to resolve open feedback without leaving the agent or chat surface.
Example Prompts
  • "Create a new Word doc in my OneDrive called Q2 Launch Brief and populate it with this outline as HTML headings and bullets."
  • "Read the document at this SharePoint URL and give me a one paragraph summary plus a list of every open comment."
  • "Open the spec at this OneDrive link and add a comment on the API section asking the author to clarify the rate limit."
  • "Reply to comment ID abc123 in the design doc with: Confirmed, we are going with option B."
  • "Fetch the comments from the contract draft at this URL and tell me which ones are still unresolved."
Pros
  • Official Microsoft offering, part of the Agent 365 Work IQ catalog with enterprise-grade governance, observability, and policy enforcement.
  • Fully remote and hosted, no local server to install, build, or maintain.
  • Native integration with OneDrive, SharePoint, and Microsoft Graph, including DriveItem metadata and comment threads.
  • Supported across Copilot Studio, Microsoft Foundry, VS Code, GitHub Copilot CLI, and Claude Code.
Limitations
  • Currently in preview, with restricted functionality and subject to supplemental terms.
  • Requires a Microsoft 365 Copilot license and a Microsoft Entra app registration with consented permissions, which is non-trivial for individual developers.
  • Limited tool surface: only four operations (create, read, comment, reply). No tools for editing existing document body content, formatting, or version history.
Alternatives