Alaamri MS Project MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Alaamri MS Project MCP
An MCP server that lets Claude (or any MCP client) drive the Microsoft Project desktop app on Windows through COM automation: open and create schedules, read and edit tasks, set the status date, save a baseline and save the file.
All COM calls run on a single dedicated STA thread, because Project's COM objects must not cross threads.
Requirements
Windows
Microsoft Project desktop (installed and licensed)
Python 3.10 or newer
بالعربي: دليل التنصيب PDF · النسخة النصية · البرومبت المستخدم في الفيديو · تنصيب بنقرة واحدة:
install.bat
Related MCP server: OmniPlan MCP Server
Install
Quick (Windows): double-click install.bat (on its own or inside the downloaded ZIP). It installs the server into %LOCALAPPDATA%\Alaamri-MSProject-MCP (from this folder if server.py is next to it, otherwise the latest version from GitHub) and registers it in Claude Desktop automatically, keeping a .bak of your config. Then fully quit and reopen Claude Desktop. Run it again any time to update.
Manual:
git clone https://github.com/engibrrahem-wq/alaamri-msproject-mcp.git
cd alaamri-msproject-mcp
python -m venv .venv
.venv\Scripts\activate
pip install -e .Register the server
Claude Desktop
Edit %APPDATA%\Claude\claude_desktop_config.json (see examples/claude_desktop_config.json) and replace the paths with your clone location:
{
"mcpServers": {
"alaamri-msproject": {
"command": "C:\\path\\to\\alaamri-msproject-mcp\\.venv\\Scripts\\python.exe",
"args": ["C:\\path\\to\\alaamri-msproject-mcp\\server.py"]
}
}
}Restart Claude Desktop afterwards.
Claude Code
Add it to a project's .mcp.json (same JSON shape as above), or from the command line:
claude mcp add alaamri-msproject -- C:\path\to\alaamri-msproject-mcp\.venv\Scripts\python.exe C:\path\to\alaamri-msproject-mcp\server.pyAfter pip install -e . you can also use the console script C:\path\to\alaamri-msproject-mcp\.venv\Scripts\alaamri-msproject-mcp.exe as the command with no args.
Tools
Tool | What it does |
| Server name, version, author, license and links |
| Whether Project is running, its version, and the open projects |
| Open an |
| Create a blank project with optional start date and title |
| Dates, task counts, milestones, critical tasks, % complete, resources |
| Tasks with ID, WBS, name, duration, dates, predecessors, resources, %, slack (paged, optional critical-only filter) |
| Append tasks from a JSON array (name, duration, start, predecessors, resources, outline level, %, notes) |
| Update one task's fields by ID |
| Delete one task by ID |
| Set the project status date |
| Save Baseline 0 for the whole project |
| Save in place, or Save As |
Conventions: durations are strings like 5d or 3h, dates are ISO YYYY-MM-DD, task IDs are the visible row IDs. New projects get the Comments property "Created with Alaamri MS Project MCP"; Author and Company are left untouched.
Safety
The server edits live schedules in Project. Always work on a copy of a real schedule and use save_project with a new path. There is no undo through MCP, and delete_task shifts the IDs below the deleted row.
Author
Developed by Dr Ibrahim M.A. Alaamri: LinkedIn
License
MIT, see LICENSE.
بالعربية
Alaamri MS Project MCP خادم MCP يتيح لـ Claude (أو أي عميل MCP) التحكم في برنامج Microsoft Project المثبّت على ويندوز عبر COM: فتح الجداول الزمنية وإنشاؤها، وقراءة الأنشطة وتعديلها، وتحديد تاريخ الحالة (Status Date)، وحفظ خط الأساس (Baseline)، وحفظ الملف.
المتطلبات
نظام Windows
برنامج Microsoft Project لسطح المكتب (مثبّت ومفعّل)
Python بإصدار 3.10 أو أحدث
التثبيت
git clone https://github.com/engibrrahem-wq/alaamri-msproject-mcp.git
cd alaamri-msproject-mcp
python -m venv .venv
.venv\Scripts\activate
pip install -e .التسجيل في Claude
Claude Desktop: أضف الإعداد الموجود في
examples/claude_desktop_config.jsonإلى الملف%APPDATA%\Claude\claude_desktop_config.jsonبعد تعديل المسارات، ثم أعد تشغيل البرنامج.Claude Code: أضف الإعداد نفسه إلى ملف
.mcp.jsonفي مشروعك، أو استخدم الأمرclaude mcp addالموضّح في القسم الإنجليزي.
الأدوات
about (معلومات الخادم)، وstatus (حالة البرنامج والملفات المفتوحة)، وopen_project (فتح جدول)، وnew_project (مشروع جديد)، وproject_summary (ملخص المشروع)، وlist_tasks (قائمة الأنشطة)، وadd_tasks (إضافة أنشطة)، وupdate_task (تعديل نشاط)، وdelete_task (حذف نشاط)، وset_status_date (تاريخ الحالة)، وsave_baseline (حفظ خط الأساس)، وsave_project (حفظ الملف).
تنبيه
الخادم يعدّل الجدول المفتوح مباشرة، فاعمل دائماً على نسخة من جدول المشروع واحفظها بمسار جديد عبر save_project. لا يوجد تراجع (Undo) عبر MCP.
المطوّر
تطوير د. إبراهيم م. أ. العامري (Dr Ibrahim M.A. Alaamri): LinkedIn
الترخيص
MIT، راجع ملف LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Project management shared by people and AI agents, with persistent project state through MCP.
Project management MCP for AI agents with safe task reads and writes.
An agent-first office suite Claude & ChatGPT read and write over one MCP URL.
Project board for ChatGPT, Claude and coding agents, with scoped MCP access to projects and tasks.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceThis read-only MCP Server allows you to connect to Microsoft Project data from Claude Desktop through CData JDBC Drivers. For full CRUD support, check out the first managed MCP platform: CData Connect AI (https://www.cdata.com/ai/).9MIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude to read and analyze project schedule files in OmniPlan (.oplx) and Microsoft Project (.mpp) formats, answering questions about tasks, milestones, resources, and progress.MIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude and other LLM clients to read and write Microsoft Project files directly, covering tasks, resources, assignments, dependencies, and critical path information without needing Microsoft Project open.MIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude and other AI agents to build, edit, and analyze Microsoft Project desktop schedules on Windows through natural language, covering tasks, WBS, dependencies, resources, calendars, baselines, critical path, resource leveling, and earned value, with live changes in Project and single-step undo. It also exports results to PDF or CSV and reads project health and time-phased data for S-curves and histograms.MIT