LABSCO SUMMARY
Aimed at the one habit timesheets actually fail on — writing the entry down at the time.
The friction with time tracking is never the tracking, it is opening the app; being able to say what you worked on inside the tool you were already in removes that step. This is deliberately small — time entries, your workspace, your token — so treat it as a capture path rather than a reporting tool. The token is a personal API token from Clockify, which means it acts entirely as you.
What it is
A TypeScript server that manages your Clockify time entries from an MCP client, so a sentence about your afternoon becomes a tracked entry.
What you get
- Time entries in your Clockify workspace created and managed from a prompt rather than the Clockify UI
- Work against the Clockify v1 API, so the entries land in the same workspace your team already reports from
Requirements
A Clockify API token in CLOCKIFY_API_TOKEN and the API base URL in CLOCKIFY_API_URL. Run through tsx, installed globally, pointed at the repository source — or installed for Claude Desktop through Smithery.
Setup effort
One command plus a key — npx -y @smithery/cli install @https-eduardo/clockify-mcp-server --client claude, then supply credentials
USE CASES
01
Logging the work while you still remember it
Say what you did and for how long as you finish, rather than reconstructing the week on Friday.
02
Filling in a gap you noticed later
Add the missing entry from wherever you are, without opening the Clockify interface.
03
Keeping tracking honest on a busy day
Entries go in as the conversation moves on, so the timesheet reflects the day rather than a guess at it.
BEFORE YOU INSTALL
What to know first
Requires
- tsx on PATH
- CLOCKIFY_API_TOKEN in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @smithery/cli install @https-eduardo/clockify-mcp-server --client claudeMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"clockify-time-entries": {
"command": "tsx",
"args": [
"<YOUR_ABSOLUTE_PATH>/src/index.ts",
"--local"
],
"env": {
"CLOCKIFY_API_URL": "https://api.clockify.me/api/v1",
"CLOCKIFY_API_TOKEN": "<YOUR_CLOCKIFY_API_TOKEN>"
}
}
}
}