MCP.so
Sign In
O

OpenProject MCP Server

@AndyEverything

Basic information

Category

Other

Transports

stdio

Author

AndyEverything

Submitted by

AndyEverything

About OpenProject MCP Server

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

OpenProject MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

OpenProject MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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

Frequently asked questions

1

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.

2

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.

3

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.

4

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.

5

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.

Comments

More Other MCP servers