omniplan-mcp

# OmniPlan MCP An MCP (Model Context Protocol) server **and CLI** for reading and writing [OmniPlan](https://www.omnigroup.com/omniplan/) (.oplx) and Microsoft Project (.mpp) schedule files. > macOS only — AppleScript bridge required for .mpp and all write operations. ## Installation ```bash pip install omniplan-mcp ``` Or install from source in editable mode: ```bash cd /Users/cygnus/work/github/omniplan-mcp pip install -e . ``` ## Usage ### CLI mode (human-friendly) Read and display a schedule: ```bash # Read a complete schedule omniplan-mcp read schedule.oplx # Show a high-level summary omniplan-mcp summary schedule.oplx # Search for tasks by name omniplan-mcp search schedule.oplx "design" # List all tasks (table or tree view) omniplan-mcp tasks schedule.oplx omniplan-mcp tasks schedule.oplx --tree # List resources or dependencies omniplan-mcp resources schedule.oplx omniplan-mcp dependencies schedule.oplx ``` Modify a schedule (requires the document to be open in OmniPlan): ```bash # Find a task's ID by name omniplan-mcp lookup "Task Name" # Mark a task as complete omniplan-mcp set-done 258 omniplan-mcp set-done 258 --subtree # Add/remove dependencies omniplan-mcp add-dep 260 258 omniplan-mcp rm-dep 260 258 # Set duration (seconds, days, hours, or minutes) omniplan-mcp set-duration 258 3d omniplan-mcp set-duration 258 28800 # Add a new child task omniplan-mcp add-task 258 "Subtask" 2d # Rename, delete, clear constraints omniplan-mcp rename 258 "New Name" omniplan-mcp delete 258 omniplan-mcp clear-constraint 258 # Save the document omniplan-mcp save # JSON output (read commands) omniplan-mcp read schedule.oplx --json omniplan-mcp summary schedule.oplx --json ``` Get help: ```bash omniplan-mcp --help omniplan-mcp read --help ``` ### MCP server mode (for AI tools) Start the MCP server in stdio mode: ```bash omniplan-mcp serve ``` Configure your MCP host (e.g., Claude Code) to use it: ```json { "mcpServers": { "omniplan": { …