Metadata-Version: 2.4
Name: word-mcp-server-swadegeiger1
Version: 1.0.0
Summary: Minimal MCP server for Microsoft Word document operations
Home-page: https://github.com/swadegeiger1/word-mcp-server
Author: Swade Geiger
Author-email: Swade Geiger <swadeg@amazon.com>
License: MIT
Project-URL: Homepage, https://github.com/swadegeiger1/word-mcp-server
Project-URL: Repository, https://github.com/swadegeiger1/word-mcp-server
Project-URL: Issues, https://github.com/swadegeiger1/word-mcp-server/issues
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=0.9.0
Requires-Dist: python-docx>=1.1.0
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Word MCP Server

Minimal MCP server for Microsoft Word document operations using python-docx.

<!-- mcp-name: io.github.swadegeiger1/word-mcp -->

## Features

- **read_word_document**: Read text from .docx files
- **create_word_document**: Create new Word documents
- **append_to_document**: Add content to existing documents

## Installation

```bash
cd ~/word-mcp-server
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
chmod +x server.py
```

## Configuration

Add to `~/.kiro/settings/mcp.json`:

```json
{
  "mcpServers": {
    "word-mcp": {
      "command": "~/word-mcp-server/venv/bin/python",
      "args": ["~/word-mcp-server/server.py"]
    }
  }
}
```

**Note:** The `~` will automatically expand to your home directory, making this configuration work for any user.

## Usage Examples

**Read a document:**
```
Read the Word document at ~/Documents/report.docx
```

**Create a document:**
```
Create a Word document at ~/Documents/memo.docx with the content "Meeting Notes\n\nDiscussed Q1 goals"
```

**Append to a document:**
```
Append "Action Items:\n- Review budget" to ~/Documents/memo.docx
```
