OpenProject MCP

Name: OpenProject MCP
Author: AndyEverything

@AndyEverything

代码仓库

关于 OpenProject MCP

A Model Context Protocol (MCP) server that provides seamless integration with OpenProject API v3.

#openproject #project #management

基本信息

分类

其他

传输方式

stdio

发布者

AndyEverything

提交者

AndyEverything

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "openproject": {
      "command": "/path/to/your/project/.venv/bin/python",
      "args": [
        "/path/to/your/project/openproject-mcp.py"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is OpenProject MCP?

OpenProject MCP is a Model Context Protocol (MCP) server that provides seamless integration with OpenProject API v3, enabling LLM applications (such as Claude Desktop) to perform project management, work package tracking, and task creation. It is intended for developers who want to connect AI assistants to an OpenProject instance (cloud or self-hosted).

How to use OpenProject MCP?

Install uv (Python package manager), clone the repository, run uv sync to install dependencies, copy env_example.txt to .env and set OPENPROJECT_URL and OPENPROJECT_API_KEY, then start the server with uv run python openproject-mcp.py. For Claude Desktop, add the server configuration pointing to the Python executable or uv to the claude_desktop_config.json file.

Key features of OpenProject MCP

Full OpenProject API v3 integration
List, create, update, and delete work packages
List and create projects with filtering
Manage users, memberships, and roles
Time entry creation and management
Proxy support and configurable logging
API key–based secure authentication

Use cases of OpenProject MCP

Allow an AI assistant to fetch and display project lists from OpenProject
Let a language model create new tasks (work packages) based on user prompts
Automate time entry logging for work packages via AI commands
Manage project memberships and roles through conversational interfaces
Query and update work package status, priority, and assignees without manual UI

FAQ from OpenProject MCP

What prerequisites are needed to run OpenProject MCP?

Python 3.10 or higher, uv (fast Python package manager), and an OpenProject instance (cloud or self-hosted) with a valid API key generated from the user’s access tokens page.

Is OpenProject MCP production‑ready?

No, this is an early‑stage project with a WIP status. The README explicitly advises against using it productively and welcomes contributions.

How do I get an OpenProject API key?

Log in to your OpenProject instance, go to My account → Access tokens, click + Add, name the token, and copy the generated key.

Can I use a self‑hosted OpenProject instance?

Yes, set the OPENPROJECT_URL environment variable to your self‑hosted instance’s URL. HTTP proxy support is also available via the optional OPENPROJECT_PROXY variable.

What transport and authentication does the server use?

The server uses the standard MCP transport (stdio for Claude Desktop integration) and authenticates to the OpenProject API v3 via an API key provided in the .env file. Connections can optionally go through an HTTP proxy.