OpenProject — connecting

Connect OpenProject to Taskloc with an instance address and an API token — work packages by project, comments, statuses, time entries and custom fields

Updated:

The OpenProject connector shows work packages (tasks) from your projects and lets you comment, change status and log time.

How to connect

  1. In the app: Settings → Add tracker → OpenProject (with several organizations — Settings → All trackers (N) → Add tracker).
  2. Enter the instance address — the URL of your OpenProject, for example https://openproject.example.com.
  3. Enter the API token — you can get it in OpenProject (see below).
  4. Tap Connect — the tasks will appear in the list.

How to get an API token

  1. Open OpenProject → My account.
  2. Go to the Access tokens section → API.
  3. Create a new token and copy it.

What is supported

FeatureStatus
Viewing tasks (work packages) by project✅
Creating a task✅ — the first type available in the project is used (more)
Task comments✅
Status change✅
Time entries to the tracker✅
Custom fields (mileage, address)✅ — the field identifier is entered manually (more)
Attachments (files and photos to a task)✅
Auto-pause— (the pause is recorded only in Taskloc)

Terminology

In OpenProject tasks are called work packages, and the container is a project. The filters and cards in the app use the words "project" / "task".

Custom fields

The app builds an automatic field catalog only for Redmine and Bitrix24. For OpenProject the custom field identifier is entered manually — get it from the instance administrator and enter it in the field settings.

Deleting a task

⚠️ Deleting a task from the app deletes the work package in OpenProject permanently — OpenProject has no trash, and the task cannot be restored.

What is not supported

  • Auto-pause of an idle session in the tracker.
  • Tags (OpenProject uses categories, not tags).
  • Ready-made filters.

Troubleshooting

  • The task list is empty — check that your account has permission to view work packages in the projects.
  • Connection error — make sure the instance address is reachable and the API token is valid.