OpenProject Smithery

This MCP server provides a typed interface to interact with a self-hosted OpenProject instance, exposing CRUD operations for projects and work packages (tasks). It is designed for use with Smithery and supports local development, Docker builds, and deployment as an MCP-compatible service.

How to use

You run this MCP server and connect your MCP client to its HTTP endpoint at /mcp to perform OpenProject operations. Use the available tools to create, retrieve, list, update, and delete projects and tasks within your OpenProject instance. Start the server in development or production mode and you can test interactions with the MCP Inspector during local development.

How to install

Prerequisites You need Node.js version 18 or later and npm. You also require access to an OpenProject instance and an API key for authentication. Docker is optional if you want to containerize the server.

bash
# Install dependencies
npm install

# Build the project
npm run build

# Start in development mode
npm run dev

# Or start in production mode
npm start

# Server will be available at http://localhost:8000/mcp

Additional notes

You can test locally using the MCP Inspector to explore and invoke the OpenProject tools exposed by this MCP server. Open the Inspector and point it at http://localhost:8000/mcp to begin interacting with the available tools.

Available tools

openproject-create-project

Creates a new project in the connected OpenProject instance by providing the required project details.

openproject-get-project

Retrieves the details of a specific project by its ID from the OpenProject instance.

openproject-list-projects

Lists all projects in the OpenProject instance, with support for pagination to iterate through results.

openproject-update-project

Updates an existing project's information such as name, description, or other metadata.

openproject-delete-project

Deletes a project from the OpenProject instance.

openproject-create-task

Creates a new task (work package) within a specified project in OpenProject.

openproject-get-task

Fetches details for a specific task (work package) by its ID.

openproject-list-tasks

Lists tasks, with optional filtering by project and pagination to navigate results.

openproject-update-task

Updates an existing task (work package); requires lockVersion for concurrency control.

openproject-delete-task

Deletes a task (work package) from the project in OpenProject.