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.
-
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.
Already have an account? Sign in.
-
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.
-
Install the command line tool
On macOS or Linux, in a terminal:
curl -fsSL https://clockwork.am/install.sh | shOn Windows, in PowerShell:
irm https://clockwork.am/install.ps1 | iexIt downloads the newest release for your machine, checks it, and puts
clockworkin~/.local/binwithout sudo, or on Windows in%LOCALAPPDATA%\Programs\clockworkwithout asking for an administrator, adding that to yourPATH. Run it again to upgrade.Then:
clockwork hooks install claudeIt 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
/mcpin 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.
-
Connect Claude Code
Add Clockwork as an MCP server:
claude mcp add --transport http clockwork https://clockwork.am/api/mcpOr, so that every project on this machine can use it:
claude mcp add --transport http clockwork https://clockwork.am/api/mcp --scope userThen run
/mcpin Claude Code and pickclockwork. 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.