OpenProject — connecting
Instance address and API token — connecting OpenProject
The OpenProject connector shows work packages (tasks) from your projects and lets you comment, change status and log time.
How to connect
- In the app: Settings → Organizations → organization → Integrations → "+" → OpenProject.
- Enter the instance address — the URL of your OpenProject, for example
https://openproject.example.com. - Enter the API token — you can get it in OpenProject (see below).
- Tap Connect — the tasks will appear in the list.
How to get an API token
- Open OpenProject → My account.
- Go to the Access tokens section → API.
- Create a new token and copy it.
What is supported
| Feature | Status |
|---|---|
| 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.