Home Time Tracking & Timer Connecting first-party apps and browser extensions

Connecting first-party apps and browser extensions

Last updated on May 19, 2026

Connecting first-party apps and browser extensions

Timether works with companion clients such as the Chrome extension, Firefox extension, desktop app, and mobile apps. These apps help you track time more easily from the tools and devices you already use.

To connect a Timether companion app, you need to sign in to your Timether cloud account and authorize the app for the correct workspace.

Plan requirement

First-party app access is available on paid plans that include the first_party_app_access entitlement.

This is included in:

  • Solo Pro

  • Team

  • Business

First-party app access is not available on the Free plan.

If you are using the Free plan, you may need to upgrade before connecting Timether’s browser extensions, desktop app, or mobile apps to your cloud account.

How the connection flow works

Timether uses a secure connect flow for first-party apps.

When you connect a browser extension or companion app, the app will open Timether in your browser and ask you to sign in if you are not already signed in.

After you choose the workspace and approve the connection, Timether sends the app back a secure access token and workspace ID.

The access token usually starts with tthr_. This token allows the companion app to communicate with your Timether account for the selected workspace.

You do not need to manually copy or paste this token in most cases. The app should receive it automatically after the connection is approved.

Connecting the Chrome extension

To connect the Timether Chrome extension:

  1. Install the Timether Chrome extension.

  2. Open the extension from your browser toolbar.

  3. Click Connect Timether or Sign in.

  4. A Timether sign-in page will open.

  5. Sign in to your Timether account.

  6. Select the workspace you want to connect.

  7. Approve the connection.

Once approved, the extension will return to Chrome and complete the connection automatically.

After connecting, the extension will be linked to the selected workspace. Any time tracking actions from the extension will use that workspace.

Connecting the Firefox extension

To connect the Timether Firefox extension:

  1. Install the Timether Firefox extension.

  2. Open the extension from your browser toolbar.

  3. Click Connect Timether or Sign in.

  4. Sign in to your Timether account when prompted.

  5. Select the workspace you want to use.

  6. Approve the connection.

After approval, Timether will redirect back to the Firefox extension with the required connection details.

The extension will then use the connected workspace for time tracking.

Connecting the desktop app

To connect the Timether desktop app:

  1. Open the Timether desktop app.

  2. Click Connect account or Sign in.

  3. Your browser will open the Timether sign-in page.

  4. Sign in to your Timether account.

  5. Select the workspace you want to connect.

  6. Approve the connection.

After approval, return to the desktop app. The app should complete the connection automatically.

If the app does not update immediately, try reopening it or using the connect option again.

Connecting the mobile app

To connect the Timether mobile app:

  1. Open the Timether mobile app.

  2. Tap Sign in or Connect account.

  3. Sign in using your Timether account.

  4. Choose the workspace you want to use.

  5. Approve the connection.

Once connected, the mobile app will use your selected workspace for time tracking and related actions.

Workspace selection

When connecting a companion app, make sure you select the correct workspace.

The app connection is scoped to the workspace you approve during the connect flow. This helps keep time entries, projects, clients, and settings separated between different teams or businesses.

If you work across multiple workspaces, you may need to reconnect or switch workspace depending on the app you are using.

Browser extension redirect safety

For security, Timether only allows browser extension redirects to approved URL formats.

Chrome extension redirect URLs must end with:

  • .chromiumapp.org

Firefox extension redirect URLs must either end with:

  • .extensions.allizom.org

  • .extensions.mozilla.org

Or use the local Firefox OAuth redirect format:

These rules help make sure that connection tokens are only returned to trusted browser extension redirect URLs.

About the connection token

During the connect flow, Timether creates a secure token for the companion app. This token usually begins with tthr_.

The token is used by the app to access your Timether account for the selected workspace.

You should not share this token with anyone. Treat it like a password because it allows access to your Timether workspace through the connected app.

If you think a token or app connection has been exposed, disconnect the app from your account settings and reconnect it again.

Troubleshooting

If you cannot connect a companion app, first check whether your current plan includes first-party app access.

If the connection page opens but does not return to the app, make sure you are using the official Timether app or extension.

For browser extensions, the redirect URL must match Timether’s allowed safety rules. Unsupported redirect URLs will be blocked for security reasons.

If the app connects to the wrong workspace, disconnect it and repeat the connect flow, then choose the correct workspace during approval.