How do I use OmniPlan MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@OmniPlan MCP Server Show me the project summary and progress percentage." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

OmniPlan MCP Server

by cygnusyang

Overview Schema Related Servers Score Discussions

Python

Local

OmniPlan MCP Server

A Model Context Protocol (MCP) server that lets Claude read and analyze project schedule files — OmniPlan (.oplx) and Microsoft Project (.mpp) formats.

Ask Claude questions like:

"What's the current project schedule?"
"List all milestones and their dates"
"Show me tasks related to the robotic arm"
"What's the overall progress percentage?"

Features

Feature	Description
📂 Read .mpp	Parse Microsoft Project files via OmniPlan bridge
📂 Read .oplx	Direct XML parsing (no OmniPlan needed)
🏛️ Full hierarchy	Groups, tasks, milestones with dates and progress
🔍 Search	Find tasks by keyword across the entire schedule
👤 Resources	List all human resources and assignments
📊 Summary	Phase overview, progress statistics, timeline
🔒 Safe concurrency	Cross-process lock prevents conflicts when multiple Claude sessions run

Related MCP server: Apple Calendar MCP Server

Prerequisites

Requirement	Notes
macOS	Required (for AppleScript/OmniPlan bridge)
Python 3.10+	For running the MCP server
OmniPlan	Only needed for `.mpp` files; `.oplx` works without it

Install OmniPlan (optional — only for .mpp files)

brew install --cask omniplan

First run: macOS may prompt for Accessibility/Automation permissions when OmniPlan is called via AppleScript. Grant them in System Settings → Privacy & Security → Automation.

Quick Start

1. Install

# Option A: One-line installer (recommended)
curl -fsSL https://raw.githubusercontent.com/cygnusyang/omniplan-mcp/main/install.sh | bash

# Option B: Manual clone
git clone https://github.com/cygnusyang/omniplan-mcp.git
cd omniplan-mcp
pip install -e .

2. Configure Claude Code

Add to your ~/.claude/settings.json:

{
  "mcpServers": {
    "omniplan": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "/Users/yourusername/.local/share/omniplan-mcp",
        "omniplan-mcp"
      ],
      "env": {}
    }
  }
}

{
  "mcpServers": {
    "omniplan": {
      "command": "uvx",
      "args": ["omniplan-mcp"],
      "env": {}
    }
  }
}

{
  "mcpServers": {
    "omniplan": {
      "command": "/path/to/python3",
      "args": ["-m", "omniplan_mcp"],
      "env": {
        "PYTHONPATH": "/path/to/omniplan-mcp/src"
      }
    }
  }
}

3. Restart Claude Code

The MCP server will start automatically. You can now ask Claude about your project files!

Usage Examples

Read a project schedule

你：帮我读取 PLB1011 项目计划，看看有哪些阶段
Claude：调用 read_schedule → 显示完整任务树

List milestones

你：列出所有里程碑节点
Claude：调用 list_milestones → 显示所有 ◇ 里程碑

Search for tasks

你：搜索所有关于"机械臂"的任务
Claude：调用 search_tasks → 显示匹配的任务列表

Project summary

你：这个项目的整体进度怎么样？
Claude：调用 schedule_summary → 显示阶段概览和进度统计

Tools Reference

Tool	Description	Parameters
`read_schedule`	Full task hierarchy with dates and progress	`filepath` (required), `format`: tree/flat/json
`list_milestones`	All milestone tasks	`filepath`
`list_resources`	All human resources	`filepath`
`search_tasks`	Search tasks by keyword	`filepath`, `keyword`
`schedule_summary`	Phase overview and progress stats	`filepath`

How It Works

.mpp file ──→ OmniPlan (AppleScript) ──→ .oplx (XML) ──→ MCP Server ──→ Claude
                          ↑
.oplx file ───────────────┴─── direct XML parsing ──────┘

For .oplx files

Direct XML parsing — fast, no external dependencies.

For .mpp files

MCP server opens the .mpp file in OmniPlan via AppleScript
Exports to .oplx format
Parses the exported XML
Cleans up temporary files

A cross-process file lock prevents AppleScript conflicts when multiple Claude Code sessions run simultaneously.

Project Structure

omniplan-mcp/
├── install.sh                  # One-click installer
├── pyproject.toml              # Package metadata (PyPI-ready)
├── README.md                   # This file
├── LICENSE                     # MIT license
├── .gitignore
├── src/
│   └── omniplan_mcp/
│       ├── __init__.py         # Package version
│       ├── __main__.py         # CLI entry point
│       ├── server.py           # MCP server (tools & handlers)
│       ├── parser.py           # .mpp / .oplx file parsing
│       └── lock.py             # Cross-process file lock
└── tests/
    └── test_parser.py          # Unit tests

Development

# Clone
git clone https://github.com/cygnusyang/omniplan-mcp.git
cd omniplan-mcp

# Install in editable mode
pip install -e .

# Run tests
python -m pytest tests/

# Run the server directly (stdio)
python -m omniplan_mcp

Publishing to PyPI

# Install build tools
pip install build twine

# Build
python -m build

# Upload to TestPyPI first
twine upload --repository testpypi dist/*

# Upload to PyPI
twine upload dist/*

Requirements

Python 3.10+
macOS (for OmniPlan AppleScript bridge)
OmniPlan (only for .mpp files; optional for .oplx)

Limitations

.mpp parsing requires OmniPlan to be installed
Only supports macOS (AppleScript dependency)
Does not modify .mpp files — read-only

License

MIT License — see LICENSE for details.

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cygnusyang/omniplan-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server