Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OPENPROJECT_URL | Yes | The URL of your OpenProject instance (e.g., https://your-instance.openproject.com) | |
| OPENPROJECT_API_KEY | Yes | Your OpenProject API key for authentication. Get this from My Account > Access tokens > + API in your OpenProject instance. |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_work_package | Create a new work package in a project. Args:
project_id: Project identifier or ID
subject: Work package title (required)
description: Work package description in markdown format
type_id: Type ID (default: 1 for Task)
status_id: Status ID (optional, uses project default if not provided)
priority_id: Priority ID (optional, uses default if not provided)
assignee_id: User ID to assign the work package to
notify: Whether to send notifications (default: True) |
| get_work_package | Get detailed information about a work package. Args:
work_package_id: Work package ID |
| update_work_package | Update an existing work package. Args:
work_package_id: Work package ID
lock_version: Current lock version (get from work package first)
subject: New subject/title
description: New description in markdown
status_id: New status ID
priority_id: New priority ID
assignee_id: New assignee user ID (use 0 to unassign)
notify: Whether to send notifications (default: True) |
| list_work_packages | List work packages with optional filtering and pagination. Args:
project_id: Optional project ID to filter work packages
filters: Optional JSON filter string
page: Page number (default: 1)
page_size: Items per page (default: 20) |
| delete_work_package | Permanently delete a work package. Args:
work_package_id: Work package ID to delete |
| get_available_assignees | Get list of users who can be assigned to work packages in a project. Args:
project_id: Project identifier or ID |
| add_watcher | Add a user as a watcher to a work package. Args:
work_package_id: Work package ID
user_id: User ID to add as watcher |
| remove_watcher | Remove a user from work package watchers. Args:
work_package_id: Work package ID
user_id: User ID to remove from watchers |
| get_work_package_schema | Get the schema for creating/updating work packages. Args:
project_id: Project identifier or ID
type_id: Optional type ID to get type-specific schema |
| set_parent_work_package | Set or remove the parent of a work package. Args:
work_package_id: Child work package ID
parent_id: Parent work package ID (use None to remove parent)
lock_version: Current lock version (get from work package first)
notify: Whether to send notifications (default: True) |
| get_work_package_activities | Retrieve all activities and comments for a work package. Args:
work_package_id: Work package ID
page: Page number (default: 1)
page_size: Items per page (default: 20) |
| create_comment | Add a comment to a work package. Args:
work_package_id: Work package ID
comment: Comment text in markdown format
internal: Whether the comment is internal (default: False) |
| get_activity | Get details of a specific activity. Args:
activity_id: Activity ID |
| update_comment | Update an existing comment. Args:
activity_id: Activity ID of the comment to update
comment: New comment text in markdown format
lock_version: Current lock version (get from activity first) |
| get_project | Get detailed information about a project. Args:
project_id: Project identifier or ID |
| list_projects | List all accessible projects with optional filtering and pagination. Args:
filters: Optional JSON filter string
page: Page number (default: 1)
page_size: Items per page (default: 20) |
| update_project | Update an existing project. Args:
project_id: Project identifier or ID
lock_version: Current lock version (get from project first)
name: New project name
description: New project description in markdown
public: Whether project is public
active: Whether project is active |
| list_work_package_relations | Get all relations for a work package. Args:
work_package_id: Work package ID |
| create_relation | Create a relation between two work packages. Args:
from_id: Source work package ID
to_id: Target work package ID
relation_type: Type of relation (relates, duplicates, blocks, precedes, follows, includes, partof, requires)
lag: Optional lag in days for precedes/follows relations |
| get_relation | Get details of a specific relation. Args:
relation_id: Relation ID |
| delete_relation | Remove a relation between work packages. Args:
relation_id: Relation ID to delete |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |