MCP.so
Sign In
O

OpenProject MCP

@AndyEverything

Repository

About OpenProject MCP

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

#openproject#project#management

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"
      ]
    }
  }
}

Tools

No tools detected

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

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.

Frequently asked questions

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.

Comments

Basic information

Category

Other

Transports

stdio

Author

AndyEverything

Submitted by

AndyEverything

More Other MCP servers

Inbox Zero AI MCP

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K