Track Your Time
Start timers, log hours and summarise time in Track Your Time from your assistant
- Pricing
- Open source
- Platforms
- CLI, self-hosted, Web
- Runs
- Locally
- Version
- 0.3.0
- Listing updated
- 2 days ago
About Track Your Time
Track Your Time is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
This stdio server connects an assistant to a Track Your Time workspace through a personal API token, so you can say start a timer for the Acme website or ask what you worked on last week. It works with the hosted service and with a self-hosted instance via TRACKYOURTIME_API_URL, since the REST API is the same code on both.
The token's scopes decide which tools appear. A read-only token never shows start_timer to the assistant. Timer and entry tools need entries scopes, client, project, task and tag tools need catalog scopes, and summary_report needs reports:read. With catalog read access, timer answers include project, client and task names instead of bare ids.
The docs list limits: it is stdio only with no hosted MCP endpoint, it has no invoice tools because the API has no invoice routes, and a token reaches one workspace. It needs Node.js 24 or newer and is licensed AGPL-3.0-or-later.
Install
Run in a terminal
claude mcp add trackyourtime --env TRACKYOURTIME_API_TOKEN='<TRACKYOURTIME_API_TOKEN>' -- npx -y trackyourtime-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"trackyourtime": {
"command": "npx",
"args": [
"-y",
"trackyourtime-mcp"
],
"env": {
"TRACKYOURTIME_API_TOKEN": "<TRACKYOURTIME_API_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"trackyourtime": {
"command": "npx",
"args": [
"-y",
"trackyourtime-mcp"
],
"env": {
"TRACKYOURTIME_API_TOKEN": "<TRACKYOURTIME_API_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"trackyourtime": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"trackyourtime-mcp"
],
"env": {
"TRACKYOURTIME_API_TOKEN": "<TRACKYOURTIME_API_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"trackyourtime": {
"command": "npx",
"args": [
"-y",
"trackyourtime-mcp"
],
"env": {
"TRACKYOURTIME_API_TOKEN": "<TRACKYOURTIME_API_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"trackyourtime": {
"command": "npx",
"args": [
"-y",
"trackyourtime-mcp"
],
"env": {
"TRACKYOURTIME_API_TOKEN": "<TRACKYOURTIME_API_TOKEN>"
}
}
}
}Configuration
TRACKYOURTIME_API_TOKENA workspace API token created in Settings → Integrations.RequiredTRACKYOURTIME_API_URLAPI origin. Defaults to https://api.trackyourtime.dev; use your own instance's origin for self-hosting.
Tools this server provides (15)
Taken from the project documentation; the running server may differ.
- get_token_info
- Shows the token's details
- get_running_timer
- Shows the running timer
- list_entries
- Lists time entries
- start_timer
- Starts a timer
- stop_timer
- Stops the timer
- log_time_entry
- Logs a time entry
- list_clients
- Lists clients
- list_projects
- Lists projects
- list_tasks
- Lists tasks
- list_tags
- Lists tags
- create_client
- Creates a client
- create_project
- Creates a project
- create_task
- Creates a task
- create_tag
- Creates a tag
- summary_report
- Summarises hours
What it does
- Scope-aware tools
- Only the tools a token's scopes allow are offered.
- Timers and entries
- Start, stop and log time, and list entries.
- Catalog management
- List or create clients, projects, tasks and tags.
- Summary reports
- Summarise hours from your own data.
- Hosted or self-hosted
- Point it at your own instance with an environment variable.
- Readable names
- Catalog access adds project and client names to answers.
Good for
- Start a timer by voice-like request in a coding chat
- Backfill hours you forgot to log
- Ask for last week's hours by project
- Create a client and project without opening the app
- Give an assistant read-only access to your time data
Pricing
Open source
AGPL-3.0-or-later; works with the hosted service or your own server (hosted plan prices not given)
Prices change. Check trackyourtime.dev before you buy.
Track Your Time FAQ
What do I need?
Node.js 24 or newer and a Track Your Time API token created in Settings, Integrations.
Can it create invoices?
No. There are no invoice tools; invoices stay in the web app.
Does it work with a self-hosted instance?
Yes. Set TRACKYOURTIME_API_URL to your instance's origin.
How do I limit what the assistant can do?
Tick only the scopes you want when creating the token.
Is Track Your Time free?
Yes. Track Your Time is open source, so you can use and self-host it for free.
How do I add Track Your Time to Claude Code?
Run this command in your terminal: claude mcp add trackyourtime --env TRACKYOURTIME_API_TOKEN='<TRACKYOURTIME_API_TOKEN>' -- npx -y trackyourtime-mcp
What are the best alternatives to Track Your Time?
The closest alternatives to Track Your Time are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.
Alternatives to Track Your Time

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media