macos-office365

This MCP server provides automation tools to create and manipulate Microsoft Office documents on macOS (PowerPoint, Word, and Excel) via MCP-compatible AI assistants. It exposes a set of specialized tools that let you create new presentations, documents, and workbooks, add content such as slides, text, images, headings, tables, and charts, and then save the results to files. The server relies on AppleScript integration to control the native Office apps, so it requires macOS permissions for automation. Use the tools to compose complex documents programmatically, orchestrating multiple steps (e.g., create a presentation, add slides, insert content, apply styling, and save to a file) in a single workflow. The available tool groups cover PowerPoint, Word, and Excel actions, plus utility functions to inspect open Office documents or check the status of Office apps.

Prerequisites:

• macOS 10.15 or later
• Python 3.8 or later
• Microsoft Office for Mac (PowerPoint, Word, and/or Excel)

Installation steps:

1. Clone the repository and navigate to the project directory:

git clone https://github.com/vAirpower/macos-office365-mcp-server.git
cd macos-office365-mcp-server

2. Install Python dependencies:

pip install -r requirements.txt

3. Grant macOS automation permissions for Office apps:

• Open System Preferences > Security & Privacy > Privacy > Automation
• Allow your terminal application (Terminal, iTerm2, VS Code, etc.) to control Microsoft PowerPoint, Microsoft Word, and Microsoft Excel
• If prompted during first run, approve the prompts to enable automation

4) Run the MCP server:
```bash
python src/office365_mcp_server.py

5. Integrate with your MCP client by pointing it to the server script location in your client configuration.

Notes and tips:

• This is a Python-based MCP server that uses AppleScript under the hood to drive Office apps; ensure you have opened the Office apps at least once to grant accessibility permissions.
• If you encounter issues like 'Not authorized to send Apple events', recheck Automation permissions and consider restarting the terminal after changes.
• Dependencies include python-pptx, python-docx, and openpyxl; ensure the versions align with your Python environment.
• The server script path in configurations should be the absolute path to src/office365_mcp_server.py.
• If Office apps fail to respond, confirm they are installed in the standard Applications folder and that macOS permissions are correctly set for the terminal/process invoking the script.