doc-tools
Word document reading and writing MCP implemented in Node.js
What is doc-tools?
doc-tools is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to word document reading and writing mcp implemented in node.js
Word document reading and writing MCP implemented in Node.js
This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- create_document
- open_document
- add_paragraph
- add_table
- search_and_replace
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @puchunjie/doc-tools-mcpManual Installation
npx -y @puchunjie/doc-tools-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use doc-tools
doc-tools-mcp is a Node.js MCP server that lets Claude and other MCP clients create, open, and manipulate Microsoft Word (.docx) documents programmatically. It exposes seven tools covering the full document lifecycle—from creating blank files and inserting paragraphs to building tables, searching and replacing text, and adjusting page margins—all without requiring Microsoft Word to be installed for basic operations.
Prerequisites
- Node.js 14 or higher installed
- An MCP-compatible client such as Claude Desktop or Cursor
- Write access to the filesystem paths where documents will be created or read
- Microsoft Word (optional, only needed for advanced rendering features)
Install via npx
The server is published to npm as @puchunjie/doc-tools-mcp and requires no global installation. Run it directly with npx so the latest version is always used.
npx @puchunjie/doc-tools-mcpAdd to Claude Desktop configuration
Open your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS) and add the server entry under mcpServers. No environment variables are required.
{
"mcpServers": {
"doc-tools": {
"command": "npx",
"args": ["-y", "@puchunjie/doc-tools-mcp"]
}
}
}Restart Claude Desktop
Quit and reopen Claude Desktop so the new MCP server entry is loaded. You should see doc-tools listed in the connected servers panel.
Create your first document
Ask Claude to create a new Word document. The create_document tool writes a .docx file to the path you specify.
Add content and tables
Use add_paragraph to insert text content and add_table to insert tabular data. The tools accept row and column counts along with cell data.
Search and replace text
The search_and_replace tool finds all occurrences of a string in the document and substitutes the replacement text, useful for template-based document generation.
doc-tools Examples
Client configuration
Minimal Claude Desktop configuration for doc-tools-mcp using npx.
{
"mcpServers": {
"doc-tools": {
"command": "npx",
"args": ["-y", "@puchunjie/doc-tools-mcp"]
}
}
}Prompts to try
Example natural-language prompts that exercise the available tools.
- "Create a new Word document at ~/Documents/report.docx"
- "Add a heading paragraph 'Q2 Sales Report' to report.docx"
- "Insert a 4-column, 5-row table with the following data into report.docx"
- "Search for 'DRAFT' and replace it with 'FINAL' in report.docx"
- "Set the top and bottom margins to 1 inch in report.docx"
- "Show me the metadata for report.docx"Troubleshooting doc-tools
npx command not found or server fails to start
Ensure Node.js 14+ is installed by running 'node --version'. If npx is missing, install it with 'npm install -g npx'. Also verify your internet connection so npx can download the package.
Document creation fails with a permission error
Check that Claude Desktop (or the process running npx) has write permission to the target directory. Try a path inside your home directory first, such as ~/Documents/test.docx.
Claude does not show doc-tools in the MCP server list
Confirm the JSON in claude_desktop_config.json is valid (no trailing commas, correct brackets). Restart Claude Desktop completely after saving the config file.
Frequently Asked Questions about doc-tools
What is doc-tools?
doc-tools is a Model Context Protocol (MCP) server that word document reading and writing mcp implemented in node.js It connects AI assistants to external tools and data sources through a standardized interface.
How do I install doc-tools?
Install via npm with the command: npx -y @puchunjie/doc-tools-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with doc-tools?
doc-tools works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is doc-tools free to use?
Yes, doc-tools is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
doc-tools Alternatives — Similar File Systems Servers
Looking for alternatives to doc-tools? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.
Electerm
★ 14.1k📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)
Plik
★ 1.8kPlik is a temporary file upload system (Wetransfer like) in Go.
Kordoc
★ 957An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.
macOS Automator
★ 801A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.
PDF Reader
★ 723Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.
Filesystem MCP Server
★ 643Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.
Browse More File Systems MCP Servers
Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up doc-tools in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use doc-tools?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.