Mobile Timer for Clockify starts, stops and switches a Clockify timer from an Obsidian note

Control your Clockify timer from the note you work in, and see the running clock and today's total.

MIT · no telemetry · core features free

The timer panel beside the note Writing log, with a running timer at 0:27:15, a day total of 3h 07m and three finished entries.
Open larger
version
1.0.1
released
downloads
0
review
Passed
health
Excellent
license
MIT
listed for
Desktop, Mobile
obsidian
1.13.4 or later

The end-to-end tests run in the desktop app only, with a stand-in for Clockify, and no test calls the real Clockify service. The directory lists the plugin for desktop and mobile, and no test in the repository ran on a phone or tablet.

Directory facts fetched from community.obsidian.md/users/theluckystrike.

About Mobile Timer for Clockify

You track time in Clockify and want to start and stop the timer from the note you write in.

Mobile Timer for Clockify starts, stops and switches your Clockify timer from a note, and shows the running timer and today's total. It calls Clockify with the request function that Obsidian gives to plugins, and it imports no Node module. The directory lists it for desktop and mobile, and no test ran on a phone or tablet.

The plugin talks to a third-party service, Clockify, with your own API key. It is an unofficial plugin, and Clockify and CAKE.com do not make or approve it. Clockify is a mark of its owner. The timer, the panel, the day total and one default project are free, and Pro adds pickers, reports, edits and an offline queue.

A desktop window where the timer panel shows no timer running. The Start timer window opens with the description Writing log. A timer then runs at 0:27:14, and after the stop the panel lists four finished entries.Play demo

Free features

Start, stop and switch a timer

Run Start timer, and a window asks for a description and offers the name of the open note. Stop timer stops the running timer, and a start while a timer runs stops that timer first. Start timer for this note starts with no window and uses the default project from the settings.

The Start timer window with the description Writing log, and a Project row that says No default project.
Open larger

Choose whether the note name goes to Clockify

The setting Use the note title as the description is on by default. With it on, the name of the open note becomes the description of a new time entry, and Clockify receives it. With it off, the plugin sends no note name unless you type one.

The plugin settings with the Clockify API key row, the default project, and the switch Use the note title as the description turned on.
Open larger

The timer panel and the ribbon button

The command Open timer panel shows the running timer, its clock, today's total, the buttons and up to 25 finished entries of today. The ribbon button stops a running timer or opens the Start window, and it turns red while a timer runs. The clock counts from the start time that Clockify holds, so the plugin sends no request for it.

The status bar on desktop

On desktop the status bar shows the clock, the project and description, and today's total. Select it to open the panel, or turn it off in the settings. The plugin adds no status bar item on mobile, where Obsidian does not support one.

The status bar shows 0:27:17, the project Docs, the entry Draft the release notes and the day total 3h 07m.
Open larger

A request budget

The plugin has a cap of 120 requests in a rolling hour, because the Clockify API docs name no limit for a personal key. Background refreshes stop when 8 requests are left, and your own actions can use the rest. After HTTP 429 the plugin follows the Retry-After header, or waits 1 minute, then longer, up to 20 minutes.

The timer panel with the line Request limit reached, retry in 1 min, and 111 of 120 plugin requests left this hour.
Open larger

The free version gives each timer the one default project from the settings, and it has no pickers, reports, edits or queue.

Pro features

Pro costs $5 a month or $15 one time through GitHub Sponsors. One sponsorship turns on Pro in every plugin that has it.

Project and tag pickers Pro

With Pro the Start window has a project list and a tags field for up to 10 tag names. A note can set its own project with a property named clockify-project, which holds the name of an active project. The property works after the plugin has loaded your project list, for example with Load projects in the settings.

The Start timer window over the note Project plan, with the project list set to Code and an empty tags field.
Open larger

Reports by project, day or description Pro

A clockify-report code block draws a table of hours by project, day or description. The range line takes today, yesterday, last7, week, month, or two dates up to 366 days apart. The plugin reads up to 500 entries in each request and keeps the answer for 15 minutes.

The note Weekly report with two tables, hours by project and hours by day, each with a total of 24.37.
Open larger

Edit and delete past entries Pro

With Pro, each finished entry of today in the panel has an edit button. The window changes the description, the project, and the start and stop time, and it keeps the tags. Delete removes the entry from Clockify after a second selection.

The Edit time entry window for Review notes, with the project Docs, start 11:00 AM, stop 11:40 AM, and the Save and Delete buttons.
Open larger

Offline queue Pro

With no connection, a start or stop waits in a queue of up to 40 changes, and the panel shows the change. A start followed by a stop later goes out as one finished entry. Without Pro, such an action changes nothing, and a notice says so.

The timer panel with the timer Call with the team, the line No connection to Clockify, and 1 change waits to be sent.
Open larger

Set up Mobile Timer for Clockify

needs

  • Obsidian 1.13.4 or later
  • A Clockify account and your own API key.
  • A connection to Clockify for each action. With Pro, a start or stop can wait in the offline queue.
  • The plugin uses the default workspace of your Clockify account and calls api.clockify.me.

steps

  1. Install Mobile Timer for Clockify from Community plugins and enable it.

  2. In Clockify, open your profile settings and generate an API key.

  3. In the plugin settings, select the Clockify API key field, create a secret and paste the key.

  4. Select Check connection. Select Load projects if you want a default project.

  5. Open a note and run Start timer.

If the app can't find a new plugin yet, try again later. Obsidian says a plugin that passes the review shows in the app within 24 hours.

Why this exists

A search of the Obsidian community directory for Clockify found no other plugin on 11 October 2026. A search of the Obsidian forum found no post that names Clockify, so no request numbers exist for this plugin.

How to track time with Clockify in Obsidian

How it compares

The Clockify apps
Clockify makes its own apps for phone, desktop and browser, and they track time outside Obsidian. This plugin is a separate build that calls the public Clockify API from inside Obsidian.
obsidian-clockify by davojc
That plugin is on GitHub and not in the community directory, and its one release is from January 2023. It puts a timer in a code block in the note, and this plugin uses commands and a panel.

Known limits of Mobile Timer for Clockify

  • A clockify-report block counts at most 1,000 time entries for its range and shows no notice when the range holds more.
  • The Pro offline queue holds a start and a stop only, so an edit or a delete of an entry fails without a connection.
  • Pro can edit or delete only the finished entries of today, at most 25 in the panel, and the edit window cannot change the date.
  • The plugin uses the default workspace of your Clockify account and calls only api.clockify.me, with no setting for another workspace or a regional address.
  • A tag name that matches no tag in Clockify is left out of the time entry with no notice.

Questions about Mobile Timer for Clockify

Does Mobile Timer for Clockify work on iPhone, iPad or Android?

The directory lists it for desktop and mobile, and the manifest allows mobile. The code uses the request function of Obsidian and no Node module, and it opens the panel in a tab on mobile. No test in the repository ran on a phone or tablet, so treat mobile use as untested.

What does the plugin send to Clockify, and when?

Each request goes to api.clockify.me and carries your API key in a header. A start or an edit carries the description, project id, tag ids and times, and a stop carries the end time. The description is the name of the open note, unless you turn off Use the note title as the description. Requests go out when Obsidian loads or returns to the front, when you open the panel, and when you act.

Where is my Clockify API key stored?

The key is in the secret storage of Obsidian, and the file data.json holds only the name of that secret. The Obsidian developer docs say that a secret is kept in local storage for the vault. They also say that any plugin can reference a secret by its name. The file data.json does hold a copy of your recent time entries, projects and tags.

What happens when Clockify limits requests or the plugin reaches its own cap?

After HTTP 429 the plugin follows the Retry-After header, or waits 1 minute, then longer, up to 20 minutes. The panel shows that wait. At its own cap of 120 requests in a rolling hour, it sends nothing until an earlier request is an hour old. The panel and the settings show the requests that are left.

How do I get Pro, and how often does the plugin check it?

Sponsor on GitHub Sponsors for $5 a month or $15 one time, then select Sign in with GitHub in the settings. Pro stays on once GitHub reports $15 paid in total. After a successful check the plugin waits 7 days, and after a failed check it waits 6 hours.

Network use

With a saved API key, the plugin sends it to api.clockify.me when Obsidian loads or returns to the front and when you act. A new time entry carries the note name as its description, unless you turn off Use the note title as the description. After you select Sign in with GitHub, it also asks github.com and api.github.com about your sponsorship, 7 days after each successful check.

Read the full network disclosure

Mobile Timer for Clockify 1.0.1, MIT license

MIT · no telemetry · core features free