openproject-ce-mcp
MCP server for OpenProject Community Edition: projects, work packages, time tracking, meetings, wiki and more as preview-first tools for AI agents such as Claude Code, Codex and GitHub Copilot.
Install / Use
claude mcp add jtauschl -- npx -y github:jtauschl/openproject-ce-mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of openproject-ce-mcp
openproject-ce-mcp scores 84/100 on our quality scale, 2796th of 4,698 Development & Engineering skills we index.
Its MCP Server is 12 KB long, well organised into 14 sections with 1 code example: a thorough specification that gives an agent plenty to work with.
It has 44 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated today, so openproject-ce-mcp is actively maintained.
- Our last check on 2026-11-13 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-13. Automated pattern scan on 2026-11-13. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
openproject-ce-mcp compared with similar skills
All 4 of these similar skills score higher than openproject-ce-mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| openproject-ce-mcp (this skill)by jtauschl | 84 | 44 | today | MCP Server |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
Frequently asked questions
- How do I install openproject-ce-mcp?
- Run
claude mcp add jtauschl -- npx -y github:jtauschl/openproject-ce-mcp. The install tabs above show the steps for each supported agent. - Which AI agents does openproject-ce-mcp work with?
- It is written for Claude Code, Claude Desktop, GitHub Copilot and OpenAI Codex, as a MCP Server file. Other agents that read the same format can often use it too.
- Is openproject-ce-mcp safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is openproject-ce-mcp still maintained?
- The repository was last updated today, so openproject-ce-mcp is actively maintained.
Skill content
View source on GitHubOpenProject CE MCP
<!-- mcp-name: io.github.jtauschl/openproject-ce-mcp --> <p align="center"> <img src="https://raw.githubusercontent.com/jtauschl/openproject-ce-mcp/main/img/openproject-ce-mcp-hero.jpg" alt="Hero image showing a Python terminal and an OpenProject board connected by a structured data stream." width="960"> </p>An MCP server for OpenProject that lets local AI agents read and manage project data through structured, guarded tools.
The server runs as a local subprocess of your MCP client over stdio. It wraps OpenProject API v3 and exposes typed tools for projects, work packages, memberships, versions, boards, meetings, time entries, and more.
Reading this on PyPI? All links below point to the GitHub repository — the
docs/pages and images ship in the git repo and source distribution, not in the installed package itself.
Why use this MCP
- Context-frugal by design — compact, agent-shaped responses instead of raw HAL payloads (~21 fields + ~46 links per item in the raw API). Measured up to −99% tokens per response with
select; see Context efficiency for the full numbers. - Guarded writes — every write follows a preview-then-confirm pattern; there is no way to bypass it.
- Defense-in-depth project scope — MCP read/write allowlists restrict the token's effective scope in addition to OpenProject's own server-side permissions.
- Typed tools, not a raw REST client — one call per intent (list, search, create, update) instead of hand-built HAL requests and link-following.
What you can do
Projects
- List, create, copy, update, and delete projects
- Read project configurations, lifecycle phases, and admin context
- Create, update, and delete memberships and versions; list roles
Work packages
- List and search work packages with structured filters
- Create, update, and delete work packages; create subtasks; create, update, and delete relations; add comments (no edit or delete)
- Upload, read (images and text inlined for the model), and delete attachments; add and remove watchers; read activity logs
- Log, update, and delete time entries
Boards and views
- Create, read, update, and delete saved boards (queries); read views
Meetings
- Create, read, update, and delete meetings with their agenda items, sections, and outcomes
- Manage recurring meetings: create, update, and delete series; list occurrences; initialize or cancel a single occurrence
Administration and schedules (opt-in)
- Read user accounts and group memberships
- Create, update, lock, unlock, and delete users; add and remove group members
- Read and manage file storage connections (e.g. Nextcloud)
- Read and manage users' non-working times and working hours
Supporting data
- Fetch individual wiki pages by id; create, update, and delete news; read and update documents
- Read and mark notifications; read help texts, working days, and instance configuration
- Create and inspect grids; inspect custom options
All write operations follow a preview-then-confirm pattern: call a tool once to get a validated preview, then again with confirm=true to execute. There is no way to bypass this.
Scope: Community Edition
This MCP server targets OpenProject Community Edition only. It does not support Enterprise Edition features such as:
- Placeholder Users
- Portfolios
- Programs
- Custom Actions
- Baseline Comparisons
Note: OpenProject Enterprise Edition includes its own MCP server. If you have an Enterprise license, use the official Enterprise MCP instead of this one.
How it works
- Communicates with the MCP client over stdio — no remote server, no persistent storage
- The core read groups (projects, work packages, memberships, versions, boards, meetings) are on by default, but until
OPENPROJECT_READ_PROJECTSlists a project, only project-independent tools such aslist_statuses,list_typesandget_current_userare registered. Personal, admin, user-schedule, and extended metadata tools are opt-in - The project-scoped write categories are on by default, but their tools are registered only when both
OPENPROJECT_READ_PROJECTSandOPENPROJECT_WRITE_PROJECTSlist a project, and a write reaches only projects in both. The allowlists, not the category flags, are the real gate. Personal-data, admin, and user-schedule writes are opt-in - Create and update operations validate the payload against OpenProject form endpoints before writing; delete and other simple operations execute directly once confirmed
- Project scope is enforced server-side: the MCP only exposes what the configured allowlists permit
- Responses are bounded and paginated — compact summaries, not raw HAL payloads
A core reason to use this MCP instead of calling the OpenProject REST API directly: it returns context-frugal responses instead of raw HAL payloads — and not just for listing. The numbers below are measured against the same three representative work packages (real tiktoken counts, not a bytes/4 approximation); read/search/write/batch calls all land in the same −85% to −98% range. For the full per-call-type breakdown, the tool-catalog size numbers, and how to reproduce them, see Context efficiency.
| Response | Tokens | vs. raw API |
|---|---:|---:|
| Raw OpenProject REST API v3 (HAL) | ~9,992 | baseline |
| list_work_packages (MCP) | ~861 | −91% |
| list_work_packages with select (5 fields) | ~174 | −98% |
Requirements
| | | | --- | --- | | Python | 3.10 or later (tested on 3.10 to 3.13) | | OpenProject | Community Edition 16.0 or later with API v3 accessible (source-audited and smoke-tested through 17.9) | | OS | macOS 12+, Linux, or Windows 10/11 | | MCP client | any client that starts a stdio MCP server; see Clients | | Credentials | an OpenProject API token of a user who can read the projects you scope |
Installation lists which tools need a newer OpenProject version.
Install
This quickstart requires pipx; see Installation if it isn't installed yet.
pipx install openproject-ce-mcp
openproject-ce-mcp configure
openproject-ce-mcp --version
Already use uv? uv tool install openproject-ce-mcp works the same way.
See Installation
for when plain pip install is appropriate instead, and for uvx (a
zero-install, run-on-demand alternative to installing at all).
configure collects your OpenProject URL, API token, and project scope, then
writes the config for the MCP client(s) you choose. Project-scoped is
recommended: the server is then available only in the current project.
Global makes it available everywhere. Restart your MCP client afterward,
then ask it to call get_current_user or list_projects to verify.
See Installation for requirements, updating, source installs, and uninstalling, and Clients for per-client setup guides.
Documentation
Full documentation lives in docs/, starting at the
documentation hub:
- Setup: Installation · Clients · Configuration · Troubleshooting
- Using the tools: Tool reference · Work package filters · Field hiding
- Client guides: Claude / Claude Code · Claude Desktop · Codex · Cursor · VS Code / GitHub Copilot
- Contributing: Development · Architecture · Context efficiency
Configuration essentials
Your client config (.mcp.json, .codex/config.toml, or .vscode/mcp.json)
contains your API token — treat it like a password and keep it out of version
control; choose your client-specific guide from Clients
for the exact .gitignore step. configure writes a minimal config: only the values that differ from a
safe default. The core read groups and the project-scoped write categories
are enabled by default, but their project-bound tools are registered, and
project access is granted, only once you list projects in
OPENPROJECT_READ_PROJECTS (and, for writes, in OPENPROJECT_WRITE_PROJECTS
too); that allowlist pair, not the category flags, is the real gate.
See Configuration for the full environment variable
reference and what configure --quick vs. --advanced ask.
Security
Prompt Injection
User-provided text (work-package descriptions, comments, news, documents, inlined attachment text) is marked with <user-content> tags and flagged in server instructions as untrusted. Agents should treat this content as data, not as instructions.
See SECURITY.md for the full security model, including prompt injection mitigations, reporting procedures, and supported versions.
Questions and bug reports
Ask questions in GitHub Discussions. Report bugs and request features in GitHub Issues. Report security vulnerabilities privately as described in SECURITY.md.
Development
main is a frozen snapshot of the last release, not the active development
branch. See CONTRIBUTING.md for which branch to clone
(active development vs. bugfixes) and the full test suite (unit,
integration, and Docker test instances).
License
MIT — see [LICENSE](https://github.c
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
