Skip to main content
The Beebole browser extension drafts time entries from the websites you choose. It works in Chrome, Edge, and Firefox, connects directly to your Beebole account with your API key, and sends only the site address, page title, and time spent. The result shows up as suggested time entries — nothing reaches your timesheet until you accept it.
The extension only watches sites you explicitly pick, and it never reads the content of a page. Only the site address, the page title, and the time spent leave your browser.

​
Downloading and installing

1

Open the Assistant page

Click Assistant in the sidebar and scroll to the Browser extension section.
Beebole Browser extension section with Chrome / Edge and Firefox download links, the Server address https://app.beebole.com and the masked API key, each with a Copy button, and the manual install instructions

The Browser extension section of the Assistant page

2

Download the extension

Next to Download, pick Chrome / Edge or Firefox — or download the current build directly: Chrome / Edge or Firefox. Either way you get a .zip file, always the latest version.
3

Load it in your browser

Until the extension reaches the browser stores, install it manually: unzip the download, then load it in your browser — Chrome / Edge: chrome://extensions → Developer mode → Load unpacked; Firefox: about:debugging → This Firefox → Load Temporary Add-on.
4

Connect it to your account

In the extension’s options, paste the Server address and your API key — both shown with copy buttons on the Assistant page (click Show my API key if the key is hidden).
5

Pick the sites it may watch

Still in the options, choose the sites the extension is allowed to watch. Everything else is ignored.

​
How it works

While you browse a watched site, the extension measures the time you spend there and sends the site address, page title, and duration to your Beebole server. That activity becomes draft entries in the Suggested entries tray above your timesheet, where you Accept, Accept all, or Dismiss each one. The extension never reads the content of a page. The site address, the page title, and the duration are all it sends, and they are what Beebole matches your time against to propose a project or task. If your API key is rejected — it was reset, or the account it belongs to no longer has access — the extension stops tracking and tells you so, instead of retrying silently in the background. Paste the new key in its options to start it again.
Your API key gives access to your Beebole account with your permissions. If you shared it by mistake, click Reset next to the key on the Assistant page — the old key stops working immediately, and you’ll need to paste the new one into the extension.

​
Related content

Beebole AI

All of Beebole’s AI features, including how suggestions work.

Desktop app

Capture activity beyond the browser on macOS, Windows, and Linux.

Timesheets

Where suggested entries appear and get accepted.

​
Frequently asked questions

Chrome and Edge (one download) and Firefox (another). Both are downloaded from the Assistant page in Beebole and installed manually until the extension is published to the browser stores.
No. The Beebole extension only watches the sites you explicitly pick in its options, and on those sites it records nothing but the address, the page title, and the time spent. It never reads the content of a page.
No. The extension connects directly to your Beebole account with your API key — the desktop app is not required. Install both only if you want activity outside the browser suggested too.
Check the API key first. If the key was reset or lost its access, the extension stops tracking and says so in its popup rather than retrying in the background — copy the current key from the Assistant page and paste it back into the extension’s options. If the key is fine, check that the site you were on is one of the sites you allowed it to watch.
Suggestions are drafts, not records. If you dismiss them — or never accept them — they simply don’t become time entries. Accept a suggestion to turn it into a real entry on your Beebole timesheet.