Microsoft Word MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Microsoft Word MCP or direct API to find DOCX files, download documents, update content, and manage files through natural language.

Microsoft Word logoMicrosoft Word
Oauth2

Microsoft Word is Microsoft's document editor for creating and managing DOCX files in OneDrive and SharePoint. It provides familiar editing and cloud storage features for organized document workflows.

22 Tools

Try Microsoft Word now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Microsoft Word
Try asking
TOOLS

Supported Tools

Every Microsoft Word action and event your agent gets out of the box.

Add Comment

Add a Word comment to a paragraph selected by a READ_DOCX locator or by exact text that uniquely matches a main-document paragraph.

Append Content

Append plain text or supported Markdown paragraphs, headings, formatted runs, lists, rectangular tables, safe http/https/mailto links, and Courier New inline or fenced code to a DOCX body.

Copy DOCX

Copy a Graph DOCX item with both a .

Create DOCX

Create a safe DOCX containing styled paragraphs and formatted runs, bullet or decimal lists, rectangular tables, or constrained HTML/Markdown source with safe external links and inline or fenced code rendered in Courier New, plus validated inline PNG/JPEG images, page breaks, and default/first/even headers and footers.

Create DOCX sharing link

Create a view, edit, or embed sharing link for a verified DOCX.

Delete DOCX

Move one DOCX to the provider recycle bin only when its current eTag matches.

Edit DOCX

Atomically edit literal text, paragraphs, independent Latin/non-complex and complex-script run formatting, lists, rectangular tables including plain cells and rows outside merged regions, uploaded inline PNG/JPEG images, semantic comments, tracked text changes, revision acceptance or rejection, safe external hyperlinks, paired footnotes, section headers or footers, and explicit page breaks in a DOCX.

Export DOCX to PDF

Convert a DOCX of at most 2 MB to PDF through Microsoft Graph and return a temporary file reference.

Fill Template

Fill run-spanning placeholders in main-document paragraphs of a validated DOCX template snapshot, then create a new document.

Find DOCX files

Browse one folder or search a drive for DOCX files.

Find SharePoint sites

Find accessible SharePoint sites by keyword, or resolve one known hostname and site path to its site ID.

Get Microsoft Word account context

Return the signed-in Microsoft identity and primary OneDrive identifiers needed to start OneDrive DOCX work.

Invite DOCX recipients

Grant read or write access to required named recipients.

List DOCX versions

Validate the selected drive item as a DOCX, then return one page of retained versions in Microsoft Graph's newest-first order.

List OneDrive drives

Return one page of drives available to the signed-in user as the Microsoft Word toolkit's OneDrive-drive selector for DOCX workflows.

List SharePoint document libraries

Return one page of document libraries and available root folder item IDs for a SharePoint site ID.

Move or rename DOCX

Rename a DOCX, move it within the same drive, or do both, guarded by its current eTag.

Read DOCX

Inspect a DOCX as bounded rich OOXML, including paragraphs, formatted runs, tables, images, hyperlinks, footnotes, comments, revisions, page breaks, sections and styles.

Replace Text

Replace the first or all occurrences of literal text in the main document of a DOCX, including matches across Word run boundaries.

Resolve Tracked Changes

Accept or reject supported pending run-level insertions and deletions in a DOCX, either all or selected revision locators returned by READ_DOCX.

Restore DOCX version

Restore a retained DOCX version as a new current version, preserving version history, then observe the item's current metadata in a post-operation read.

Upsert DOCX

Create or replace a same-name DOCX containing the same validated content supported by CREATE_DOCX.

SETUP GUIDE

Connect Microsoft Word MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["microsoft_word"],
  mcp: true,
});
Create a session scoped to Microsoft Word and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Find the DOCX file named Q4 sales report in my OneDrive and download it.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Microsoft Word request
SETUP GUIDE

Connect Microsoft Word API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["microsoft_word"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Microsoft Word
3

Run Microsoft Word tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Find the DOCX file named Q4 sales report in my OneDrive and download it." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Microsoft Word tool calls through the session, and print the final answer

Why Use Composio?

AI Native Microsoft Word Integration

  • Supports both Microsoft Word MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for finding, downloading, updating, and managing Microsoft Word documents

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Microsoft Word access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Microsoft Word
  • Scoped, least privilege access to Microsoft Word resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Microsoft Word.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Microsoft Word tool your agent needs.Free to start.

Start building