Harvest configuration

Creating connection to Harvest

This only applies if you are hosting ManicTime Server yourself. It does not apply if you are using ManicTime Cloud.

Before users can make a connection to Harvest to get projects, ManicTime Server needs to be connected to Harvest.

  1. On Harvest, go to Harvest developer hub. Then click on the Create new OAuth2 application.
Harvest developer hub
  1. Fill the required fields
Harvest developer hub
  1. To get the redirect url for the Redirect URL field, go back to ManicTime server, Administration and under Harvest configuration, you will see a list of possible Redirect URIs.
Possible redirect URIs
  1. Copy one of them to Redirect URIs field.

  2. For Access select I need access to one account.

  3. For Products select I want access to Harvest.

  4. Click "Create application". You will see Client ID and secret fields right on the top.

Harvest Client Id and Secret fields
  1. Copy Client ID and secret to ManicTime Server Harvest Connection Configuration screen.
Copy Client Id and Secret to ManicTime Server Harvest Configuration screen
  1. Click "Test connection" to see if the connection is set properly, then save it.

When you click "Test connection", you will go through the authentication process, like all users who will try to connect to Harvest.

Editing or deleting configuration

Any changes to Client Id or Secret will delete existing connections for all users.

If you delete the configuration all users data will be also deleted.

Connection settings

In the Harvest configuration settings, you have the ability to control the visibility of projects for users. You can set up various filters to determine which projects a user can see. These filters can be based on project states (opened or completed), time frames (e.g., projects completed in the last X days) and assignment to users.

One important setting in Harvest is the "Authenticated user" setting. This refers to a specific user account that is used to authenticate and query data from Harvest. This user should have access to all projects you want to import.

Users then need to go to Administration -> My connections and authenticate with Harvest, and the tags should be visible in the add tag window.

Syncing time with Harvest

Please note that users must use tags that came from Harvest to successfully send tags back to Harvest.

This connection also has the ability to send tags back to Harvest as time entries. You can enable this feature in Connection settings. The user needs to use tags from Harvest and then they are automatically sent back to Harvest every 2 hours or you can send tags to Harvest manually, if you click the Sync now button. Tags are assigned to the Harvest user that corresponds to the ManicTime user who created the Harvest tag.

Sync now and Sync reports buttons

You can also see status of the synced tags, if you click Sync reports where you have a summary for every sync. If you click on it you have a detailed report for synced tags.

Sync reports
Sync report