# Office MCP Server

MCP server for creating and editing Word, Excel, and PowerPoint documents offline. Pure Python — no AppleScript, no COM, works on any platform.

## Features

- **Word** (.docx): create, read, add headings, paragraphs, tables, lists
- **Excel** (.xlsx): create, read, write data, formulas, charts, cell formatting
- **PowerPoint** (.pptx): create, read, add slides, text boxes

## Install

```bash
pip install office-mcp-server
```

Or run directly with uvx:

```bash
uvx office-mcp-server
```

## Configuration

### Claude Desktop

Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "office": {
      "command": "uvx",
      "args": ["office-mcp-server"]
    }
  }
}
```

### OpenCode / Claude Code

```json
{
  "mcpServers": {
    "office": {
      "command": "python",
      "args": ["-m", "office_mcp_server.server"],
      "cwd": "/path/to/office-mcp-server"
    }
  }
}
```

### Local development

```bash
git clone https://github.com/YOUR_USERNAME/office-mcp-server.git
cd office-mcp-server
pip install -e .
```

## Tools

| Tool | Description |
|------|-------------|
| `create_word_document` | Create .docx file |
| `read_word_document` | Read .docx content |
| `add_word_heading` | Add heading (level 1-6) |
| `add_word_paragraph` | Add formatted paragraph |
| `add_word_table` | Add table with headers |
| `add_word_list` | Add bullet/numbered list |
| `create_excel_workbook` | Create .xlsx file |
| `read_excel_workbook` | Read .xlsx data |
| `write_excel_data` | Write data to cells |
| `add_excel_formula` | Add formula (e.g., `=SUM(A1:A3)`) |
| `add_excel_chart` | Create bar/line/pie chart |
| `format_excel_cells` | Bold, color, alignment, border |
| `create_presentation` | Create .pptx file |
| `read_presentation` | Read slide content |
| `add_presentation_slide` | Add slide with layout |
| `add_presentation_text` | Add text box to slide |

## Example Usage

Ask your AI assistant:

> "Create a Word document at ~/Desktop/report.docx with a title 'Q4 Report', add a heading 'Revenue', and a paragraph with the text 'Revenue increased by 25%'"

> "Create an Excel file at ~/Desktop/data.xlsx, write headers Name/Score, add data rows, and create a bar chart"

> "Create a PowerPoint at ~/Desktop/slides.pptx with title 'Pitch Deck', add 3 slides with content"

## License

MIT