Set up Clockwork

Four steps, top to bottom. The first is the only one you need; the second records what your computer is doing, the third records your Claude Code sessions, and the fourth connects Claude Code, so you can ask it about your time.

  1. Sign up

    Create an account with your email address. Your workspace is made the first time you sign in, and you land in the app: on a computer that is your timeline, empty until something records time; on a phone it is the timer, so you can start one straight away.

    Sign up

    Already have an account? Sign in.

  2. Install the desktop app

    On macOS or Windows, the desktop app records which app is in front and its window title, so your timeline shows what the computer was doing while you worked. Download it, open it, and sign in from the app with the same account.

    Download the desktop app

  3. Install the command line tool

    On macOS or Linux, in a terminal:

    curl -fsSL https://clockwork.am/install.sh | sh

    On Windows, in PowerShell:

    irm https://clockwork.am/install.ps1 | iex

    It downloads the newest release for your machine, checks it, and puts clockwork in ~/.local/bin without sudo, or on Windows in %LOCALAPPDATA%\Programs\clockwork without asking for an administrator, adding that to your PATH. Run it again to upgrade.

    Then:

    clockwork hooks install claude

    It signs you in through the browser, installs the hooks that record each Claude Code session as an agent run, and registers Clockwork's MCP server with Claude Code.

    That covers most of the next step too: all that is left there is running /mcp in Claude Code once.

    macOS, Linux and Windows: Apple silicon/arm64 and Intel/x64 on macOS and Linux (glibc, so not Alpine), x64 on Windows.

    On Windows, the command line tool is not signed yet. Installed with this command it runs without the “Windows protected your PC” prompt, which is for files a browser downloads; but with Smart App Control on, Windows blocks unsigned programs, and it will not run until it is signed.

  4. Connect Claude Code

    Add Clockwork as an MCP server:

    claude mcp add --transport http clockwork https://clockwork.am/api/mcp

    Or, so that every project on this machine can use it:

    claude mcp add --transport http clockwork https://clockwork.am/api/mcp --scope user

    Then run /mcp in Claude Code and pick clockwork. Your browser opens a consent screen that names the client asking for access. Sign in if you are asked to, and allow it; Claude Code is connected, and you can ask it about your time in plain words.

    The connection shows up in Clockwork on the Actors page, under Grants, named after the client. Revoking it there disconnects it. Any other MCP client that speaks OAuth connects the same way, at https://clockwork.am/api/mcp.