# How to integrate Microsoft Word MCP with Atomic Agent

```json
{
  "title": "How to integrate Microsoft Word MCP with Atomic Agent",
  "toolkit": "Microsoft Word",
  "toolkit_slug": "microsoft_word",
  "framework": "Atomic Agent",
  "framework_slug": "atomic-agent",
  "url": "https://composio.dev/toolkits/microsoft_word/framework/atomic-agent",
  "markdown_url": "https://composio.dev/toolkits/microsoft_word/framework/atomic-agent.md",
  "updated_at": "2026-11-07T07:03:42.048Z"
}
```

## Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Microsoft Word.
This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Microsoft Word account. See the [Atomic Agent documentation](https://atomicagent.io/docs/?cta_placement=atomic-agent-docs) for installation instructions.
For exact tool slugs and parameter tables, see the [tool catalog in the Composio docs](https://docs.composio.dev/toolkits/microsoft_word).

## Also integrate Microsoft Word with

- [ChatGPT](https://composio.dev/toolkits/microsoft_word/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/microsoft_word/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/microsoft_word/framework/hermes-agent)

## TL;DR

### How Atomic Agent connects to Microsoft Word
Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.
Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

## Connect Microsoft Word to Atomic Agent

### Connect Microsoft Word to Atomic Agent
- Sign up or sign in to the [Composio dashboard](https://dashboard.composio.dev/?cta_placement=atomic-agent-api-key). Copy your API key.
- In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
- Ask Atomic Agent to do something in Microsoft Word. It searches Composio for the right tool.
- On first use, open the sign-in link returned in the chat. Connect your Microsoft Word account, then return to Atomic Agent to continue.
### Headless setup
Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

```bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY
```

## What is the Microsoft Word MCP server, and what's possible with it?

The Microsoft Word MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Microsoft Word account. It provides structured and secure access to DOCX files in OneDrive and SharePoint, so your agent can find, read, create, edit, and share documents on your behalf.
- Document discovery and reading: Have your agent find DOCX files in OneDrive or SharePoint, inspect their paragraphs, formatting, tables, images, links, and tracked changes, and review retained document versions.
- Document creation and editing: Let the agent create new Word documents, append text and tables, replace text across runs, edit formatting and lists, and update existing content.
- Templates and document workflows: Direct your agent to fill placeholders in a Word template, add comments to specific paragraphs, accept or reject tracked changes, and export a DOCX file to PDF.
- File organization and version control: Instruct your agent to copy, move, rename, replace, delete, or restore DOCX files while preserving access to available document versions.
- Sharing and collaboration: Have your agent create view, edit, or embed sharing links and invite named recipients with read or write access to a DOCX file.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `MICROSOFT_WORD_ADD_COMMENT` | 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. A locator requires the document’s eTag. |
| `MICROSOFT_WORD_APPEND_CONTENT` | 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. |
| `MICROSOFT_WORD_COPY_DOCX` | Copy DOCX | Copy a Graph DOCX item with both a .docx filename and DOCX MIME type to a OneDrive or SharePoint folder, wait boundedly for the asynchronous operation, and return verified destination metadata. If waiting times out, the server-side copy may continue. |
| `MICROSOFT_WORD_CREATE_DOCX` | 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. Literal content is escaped and raw XML or image URLs are never accepted. The create-only default fails on a filename conflict. overwrite_existing remains available for backward compatibility; prefer UPSERT_DOCX when replacement is intended. |
| `MICROSOFT_WORD_CREATE_DOCX_SHARING_LINK` | Create DOCX sharing link | Create a view, edit, or embed sharing link for a verified DOCX. When link_scope is omitted, Graph uses the drive's default scope, which can be anonymous. Returns Graph's capability-bearing URL; treat it as a secret. Sharing can change the document eTag, so call READ_DOCX again before editing. Setting retain_inherited_permissions=false removes all existing permissions when the item is shared for the first time. |
| `MICROSOFT_WORD_DELETE_DOCX` | Delete DOCX | Move one DOCX to the provider recycle bin only when its current eTag matches. This action does not bypass shared locks or checked-out state. A successful result does not guarantee permanent erasure. |
| `MICROSOFT_WORD_EDIT_DOCX` | 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. Targets are semantic locators from READ_DOCX and remain valid only for its eTag. The complete package is validated before one guarded replacement upload. |
| `MICROSOFT_WORD_EXPORT_DOCX` | Export DOCX to PDF | Convert a DOCX of at most 2 MB to PDF through Microsoft Graph and return a temporary file reference. The provider's preauthenticated redirect URL is followed internally and is never returned. |
| `MICROSOFT_WORD_FILL_TEMPLATE` | Fill Template | Fill run-spanning placeholders in main-document paragraphs of a validated DOCX template snapshot, then create a new document. Strict mode requires every requested placeholder to be found; non-strict mode can create a partial fill and reports found, filled, and unfilled keys. |
| `MICROSOFT_WORD_FIND_DOCX_FILES` | Find DOCX files | Browse one folder or search a drive for DOCX files. Browse pages also return folders for navigation. Search results can be eventually consistent; use a direct read action when authoritative current state is required. |
| `MICROSOFT_WORD_FIND_SHAREPOINT_SITES` | Find SharePoint sites | Find accessible SharePoint sites by keyword, or resolve one known hostname and site path to its site ID. |
| `MICROSOFT_WORD_GET_ACCOUNT_CONTEXT` | Get Microsoft Word account context | Return the signed-in Microsoft identity and primary OneDrive identifiers needed to start OneDrive DOCX work. Microsoft Graph documents that GET /me/drive automatically provisions OneDrive when the delegated user is licensed but does not yet have a drive. |
| `MICROSOFT_WORD_INVITE_DOCX_RECIPIENTS` | Invite DOCX recipients | Grant read or write access to required named recipients. send_invitation and require_sign_in are required; emailing an invitation is an irreversible external side effect. Partial success is reported per recipient. Sharing can change the document eTag, so call READ_DOCX again before editing. Setting retain_inherited_permissions=false removes all existing permissions when the item is shared for the first time. |
| `MICROSOFT_WORD_LIST_DOCX_VERSIONS` | 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. Provider download URLs and raw identity objects are omitted. |
| `MICROSOFT_WORD_LIST_ONEDRIVES` | 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. Unlike GET_ACCOUNT_CONTEXT, this lists drives without returning identity context or selecting only the primary drive. Use LIST_SHAREPOINT_LIBRARIES for a specific SharePoint site's document libraries; general OneDrive file automation may use ONE_DRIVE_LIST_DRIVES instead. |
| `MICROSOFT_WORD_LIST_SHAREPOINT_LIBRARIES` | List SharePoint document libraries | Return one page of document libraries and available root folder item IDs for a SharePoint site ID. |
| `MICROSOFT_WORD_MOVE_OR_RENAME_DOCX` | Move or rename DOCX | Rename a DOCX, move it within the same drive, or do both, guarded by its current eTag. At least one of new_name or destination_folder_id is required. |
| `MICROSOFT_WORD_READ_DOCX` | Read DOCX | Inspect a DOCX as bounded rich OOXML, including paragraphs, formatted runs, tables, images, hyperlinks, footnotes, comments, revisions, page breaks, sections and styles. Returns an eTag for locators, withholds download URLs, external relationship targets and document bytes, and applies a 100-megapixel aggregate bound to PNG and JPEG image records. |
| `MICROSOFT_WORD_REPLACE_TEXT` | Replace Text | Replace the first or all occurrences of literal text in the main document of a DOCX, including matches across Word run boundaries. Matching can be case-sensitive or case-insensitive, and replacements can be recorded as tracked revisions. An optional eTag guards against editing a different document version. |
| `MICROSOFT_WORD_RESOLVE_TRACKED_CHANGES` | 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. Accept-all and reject-all fail if the document contains unsupported revision forms; selected locators require the corresponding eTag. |
| `MICROSOFT_WORD_RESTORE_DOCX_VERSION` | 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. That metadata does not independently prove which version supplied the current content. A required eTag check rejects already-stale callers before mutation, but Graph does not document an atomic If-Match precondition for this operation. |
| `MICROSOFT_WORD_UPSERT_DOCX` | Upsert DOCX | Create or replace a same-name DOCX containing the same validated content supported by CREATE_DOCX. Replacement is always enabled; use CREATE_DOCX for create-only conflict behavior. |

## Supported Triggers

None listed.

## Troubleshooting

### Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

### Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

### Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See [Composio pricing](/pricing/platform) for the current limits that apply to your connection.

## Complete Code

None listed.

## Conclusion

### Use Microsoft Word from Atomic Agent
With your account connected, ask Atomic Agent to work with Microsoft Word in natural language. You can connect more apps through the same Composio integration as you need them.
Visit the [Atomic Agent website](https://atomicagent.io/?cta_placement=atomic-agent-site) or inspect the [Atomic Agent source code](https://github.com/AtomicBot-ai/atomic-agent?cta_placement=atomic-agent-repo).

## How to build Microsoft Word MCP Agent with another framework

- [ChatGPT](https://composio.dev/toolkits/microsoft_word/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/microsoft_word/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/microsoft_word/framework/hermes-agent)

## Related Toolkits

- [Google Drive](https://composio.dev/toolkits/googledrive) - Google Drive is a cloud storage platform for uploading, sharing, and collaborating on files. It's perfect for keeping your documents accessible and organized across devices.
- [Google Docs](https://composio.dev/toolkits/googledocs) - Google Docs is a cloud-based word processor that enables document creation and real-time collaboration. Its seamless sharing and version history make team editing and content management a breeze.
- [Google Super](https://composio.dev/toolkits/googlesuper) - Google Super is an all-in-one suite combining Gmail, Drive, Calendar, Sheets, Analytics, and more. It gives you a unified platform to manage your digital life, boosting productivity and organization.
- [ActiveMerge](https://composio.dev/toolkits/active_merge) - ActiveMerge is a document automation platform for generating documents, images, merged files, and e-signature workflows. It helps teams turn templates and stored files into finished, shareable documents faster.
- [Affinda](https://composio.dev/toolkits/affinda) - Affinda is an AI-powered document processing platform that automates data extraction from resumes, invoices, and more. It streamlines document-heavy workflows by turning files into structured, actionable data.
- [Agility cms](https://composio.dev/toolkits/agility_cms) - Agility CMS is a headless content management system for building and managing digital experiences across platforms. It lets teams update content quickly and deliver omnichannel experiences with ease.
- [Airparser](https://composio.dev/toolkits/airparser) - Airparser is an AI-powered parser for extracting structured data from emails, documents, PDFs, and files. It turns messy inbound content into clean fields your apps and workflows can use.
- [Algodocs](https://composio.dev/toolkits/algodocs) - Algodocs is an AI-powered platform that automates data extraction from business documents. It delivers fast, secure, and accurate processing without templates or manual training.
- [Api2pdf](https://composio.dev/toolkits/api2pdf) - Api2Pdf is a REST API for generating PDFs from HTML, URLs, and documents using powerful engines like wkhtmltopdf and Headless Chrome. It streamlines document conversion and automation for developers and businesses.
- [Archive.org](https://composio.dev/toolkits/archive_org) - Archive.org is the Internet Archive's digital library of websites, books, audio, video, and images. Use it to preserve, explore, and access historical web captures and public-domain media.
- [Aryn](https://composio.dev/toolkits/aryn) - Aryn is an AI-powered platform for parsing, extracting, and analyzing data from unstructured documents. Use it to automate document processing and unlock actionable insights from your files.
- [Boldsign](https://composio.dev/toolkits/boldsign) - Boldsign is a digital eSignature platform for sending, signing, and tracking documents online. Organizations use it to automate agreements and manage legally binding workflows efficiently.
- [Boloforms](https://composio.dev/toolkits/boloforms) - BoloForms is an eSignature platform built for small businesses, offering unlimited signatures, templates, and forms. It simplifies digital document signing and team collaboration at a predictable, fixed price.
- [Box](https://composio.dev/toolkits/box) - Box is a cloud content management and file sharing platform for businesses. It helps teams securely store, organize, and collaborate on files from anywhere.
- [Box MCP](https://composio.dev/toolkits/box_mcp) - Box MCP is Box's hosted MCP server that exposes enterprise files, folders, and metadata. It provides secure, centralized access to corporate content for search and management.
- [Carbone](https://composio.dev/toolkits/carbone) - Carbone is a blazing-fast report generator that turns JSON data into PDFs, Word docs, spreadsheets, and more using flexible templates. It lets you automate document creation at scale with minimal code.
- [Castingwords](https://composio.dev/toolkits/castingwords) - CastingWords is a transcription service specializing in human-powered, accurate transcripts via a simple API. Get seamless audio-to-text conversion for interviews, meetings, podcasts, and more.
- [CertSeal](https://composio.dev/toolkits/cert_seal) - CertSeal is an API platform for issuing and managing verifiable digital certificates. Use it to automate trusted certificate workflows for recipients, batches, designs, and webhooks.
- [Cloudconvert](https://composio.dev/toolkits/cloudconvert) - CloudConvert is a powerful file conversion service supporting over 200 file formats. It streamlines converting, compressing, and managing documents, media, and more, all in one place.
- [Cloudlayer](https://composio.dev/toolkits/cloudlayer) - Cloudlayer is a document and asset generation service for creating PDFs and images via API or SDKs. It lets you automate high-quality doc creation, saving dev time and reducing manual work.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Microsoft Word MCP?

With a standalone Microsoft Word MCP server, the agents and LLMs can only access a fixed set of Microsoft Word tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Microsoft Word and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Atomic Agent?

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Microsoft Word tools.

### Can I manage the permissions and scopes for Microsoft Word while using Tool Router?

Yes, absolutely. You can configure which Microsoft Word scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Microsoft Word data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)