OpenProject CE MCP
An MCP server for OpenProject that lets local AI agents read and manage project data through structured, guarded tools.
에이전트 강화
게시자가 제공하는 설치 방식입니다. PlugMCP 엔드포인트가 아닙니다.
원격 URL인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행게시자 제공
An MCP server for OpenProject that lets local AI agents read and manage project data through structured, guarded tools.
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.
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, 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.
select; see Context efficiency for the full numbers.Projects
Work packages
Boards and views
Users and groups
Supporting data
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.
This MCP server targets OpenProject Community Edition only. It does not support Enterprise Edition features such as:
Note: OpenProject Enterprise Edition includes its own MCP server. If you have an Enterprise license, use the official Enterprise MCP instead of this one.
OPENPROJECT_READ_PROJECTS is configuredOPENPROJECT_WRITE_PROJECTS — that allowlist, not the category flags, is the real gate; personal-data and admin writes stay opt-in separatelyA 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.
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.
Full documentation lives in docs/, starting at the
documentation hub:
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. Read tools are registered by default, and so are the 5 core
write categories — but project access stays denied either way until 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.
User-provided text (work-package descriptions, comments, news, wiki content) 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.
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).
MIT — see LICENSE. A single top-level license file covers the whole project; individual source files don't carry per-file copyright headers, matching common practice for MIT-licensed Python packages.
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.
도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
이 레코드에는 필수 환경 변수가 등록되어 있지 않습니다.
Openproject Ce은(는) stdio를 통해 로컬에서 실행됩니다.
마지막 확인: 2026-11-14. 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.