{
  "markdown": "<!-- mcp-name: io.github.dosev-ai/mcp-office-excel -->\n<!-- mcp-name: io.github.dosev-ai/mcp-office-powerpoint -->\n<!-- mcp-name: io.github.dosev-ai/mcp-office-word -->\n\n# MCP Office\n\n> Local-first, governed MCP servers for Microsoft Office — built for developers who want to treat Office files the way they treat code.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Python 3.11+](https://img.shields.io/badge/Python-3.11+-blue.svg)](https://python.org)\n[![CI](https://github.com/dosev-ai/mcp-office/actions/workflows/ci.yml/badge.svg)](https://github.com/dosev-ai/mcp-office/actions/workflows/ci.yml)\n[![PyPI](https://img.shields.io/pypi/v/mcp-office.svg)](https://pypi.org/project/mcp-office/)\n[![UAT](https://img.shields.io/badge/UAT-E2E%20validated%20on%20Windows%2011-brightgreen.svg)](CHANGELOG.md)\n\n---\n\n## What is this?\n\nMCP Office is a suite of [Model Context Protocol](https://modelcontextprotocol.io) servers that expose Microsoft Office capabilities as governed, deterministic tool calls. Each server runs locally on Windows, connects to your MCP client (Claude Desktop, VS Code Copilot, or any MCP-compatible client), and gives you structured control over Office files — without an in-app AI assistant.\n\n**This is not a Copilot replacement.** It is a developer-first execution layer for Office automation.\n\n---\n\n## Packages\n\n### ✅ Available now\n\n| Package | What it does | Install | Tools |\n|---|---|---|---|\n| [`excelmcp`](excelmcp/) | Read, write, style, validate, and export Excel workbooks | `pip install mcp-office` | 65 |\n| [`pptmcp`](pptmcp/) | Build, edit, review, and export PowerPoint presentations. Output Contract framework for machine-verifiable slide specs | `pip install mcp-office` | 46 |\n| [`wordmcp`](wordmcp/) | Template assembly, tracked-changes support, and structural QA for Word documents | `pip install mcp-office` | 50 |\n\n### 🚧 Coming next\n\n| Package | Status |\n|---|---|\n| `mailmcp` | In development — Outlook email, calendar, contacts, and MailRepo search |\n\nNew packages are added as they complete their proof cycle. See [ROADMAP.md](ROADMAP.md).\n\n---\n\n## Quick start\n\n### Prerequisites\n\n- Windows 10 or 11\n- Python 3.11 or later (`python --version`)\n- [Claude Desktop](https://claude.ai/download) or VS Code with GitHub Copilot\n- Microsoft Office (Excel / PowerPoint / Word) — required for COM-backed tools (styling, PDF export, tracked-changes)\n\n### Install\n\n> **PyPI note:** `excelmcp` on PyPI is an unrelated third-party package. Do **not** `pip install excelmcp` — that ships you a stranger's code. The published suite package is `mcp-office`.\n\n```bash\npip install mcp-office\n```\n\nOr clone and install from source (for development / COM extras):\n\n```bash\ngit clone https://github.com/dosev-ai/mcp-office.git\ncd mcp-office\npython -m venv .venv\n.venv\\Scripts\\activate\npip install -e ./excelmcp\npip install -e ./wordmcp\npip install -e ./shared && pip install -e ./pptmcp\n```\n\n### Configure Claude Desktop\n\nOpen `%APPDATA%\\Claude\\claude_desktop_config.json` (create it if it doesn't exist) and add the servers you installed:\n\n```json\n{\n  \"mcpServers\": {\n    \"excel-excelmcp\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"excelmcp.server\"],\n      \"env\": {\n        \"EXCEL_ALLOWLIST_ROOTS\": \"C:\\\\path\\\\to\\\\your\\\\files\",\n        \"EXCEL_ENABLE_WRITE\": \"true\"\n      }\n    },\n    \"powerpoint-pptmcp\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"pptmcp.server\"],\n      \"env\": {\n        \"PPT_ALLOWLIST_ROOTS\": \"C:\\\\path\\\\to\\\\your\\\\files\",\n        \"PPT_ENABLE_WRITE\": \"true\"\n      }\n    },\n    \"word-wordmcp\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"wordmcp.server\"],\n      \"env\": {\n        \"WORD_ALLOWLIST_ROOTS\": \"C:\\\\path\\\\to\\\\your\\\\files\",\n        \"WORD_ENABLE_WRITE\": \"true\"\n      }\n    }\n  }\n}\n```\n\nReplace `C:\\\\path\\\\to\\\\your\\\\files` with the directory where your Office files live. Restart Claude Desktop after saving.\n\n### Verify\n\nIn Claude Desktop, send:\n\n```\nCall capabilities() on excel-excelmcp\nCall capabilities() on powerpoint-pptmcp\nCall capabilities() on word-wordmcp\n```\n\nEach should return a tool list (65 for Excel, 46 for PowerPoint, 50 for Word). If a server is missing, check that `python` resolves to the venv where you installed `mcp-office`.\n\nFull per-package guides: [excelmcp/README.md](excelmcp/README.md) · [pptmcp/README.md](pptmcp/README.md) · [wordmcp/README.md](wordmcp/README.md)\n\nDetailed step-by-step: [docs/quickstart.md](docs/quickstart.md)\n\n---\n\n## Requirements\n\n| Requirement | Notes |\n|---|---|\n| Windows 10 or 11 | COM automation requires Windows |\n| Python 3.11+ | `python --version` to confirm |\n| Microsoft Office | Required for COM-dependent tools (styling, PDF export, tracked-changes). Read-only docx/xlsx/pptx tools work without Office. |\n| MCP client | [Claude Desktop](https://claude.ai/download) **or** [VS Code with Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) |\n\n---\n\n## Architecture\n\n```\nYour MCP client (Claude Desktop / VS Code Copilot / other)\n        │\n        │  MCP stdio protocol\n        ↓\n  MCP Office servers (local Python processes)\n   ├─ excelmcp    — Excel automation (live)\n   ├─ pptmcp      — PowerPoint automation (live)\n   ├─ wordmcp     — Word automation (live)\n   └─ mailmcp     — Outlook + MailRepo (coming)\n        │\n        │  COM / openpyxl / python-pptx / python-docx\n        ↓\n  Microsoft Office (local installation)\n```\n\nEach server is a standalone `stdio` MCP server. No network calls. No cloud dependency. Your files stay local.\n\n---\n\n## Contributing\n\nThis project is in active development. The best way to contribute right now:\n\n1. **Try any package** (excelmcp, pptmcp, wordmcp) and open a [First Run Report](https://github.com/dosev-ai/mcp-office/issues/new?template=first_run_report.yml)\n2. **Report bugs** via [GitHub Issues](https://github.com/dosev-ai/mcp-office/issues/new?template=bug_report.yml)\n3. **Ask questions or share what you built** in [GitHub Discussions](https://github.com/dosev-ai/mcp-office/discussions)\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development guidelines.\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 6150,
  "sha": "43acddf602c3df5ecfc3c30ded5e25f4a97d3eb9d9989c631233542cf16297f5",
  "repo_slug": "dosev-ai/mcp-office",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_dosev_ai_mcp_office_excel_27463530/readme"
}