# Track Your Time

> Track Your Time is an open-source MCP server for productivity. Start timers, log hours and summarise time in Track Your Time from your assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Web
- **Website:** https://trackyourtime.dev/docs/mcp/
- **Repository:** https://github.com/trebeljahr/trackyourtime/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.trebeljahr/trackyourtime
- **Categories:** productivity
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add trackyourtime --env TRACKYOURTIME_API_TOKEN='<TRACKYOURTIME_API_TOKEN>' -- npx -y trackyourtime-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "trackyourtime": {
      "command": "npx",
      "args": [
        "-y",
        "trackyourtime-mcp"
      ],
      "env": {
        "TRACKYOURTIME_API_TOKEN": "<TRACKYOURTIME_API_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "trackyourtime": {
      "command": "npx",
      "args": [
        "-y",
        "trackyourtime-mcp"
      ],
      "env": {
        "TRACKYOURTIME_API_TOKEN": "<TRACKYOURTIME_API_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "trackyourtime": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "trackyourtime-mcp"
      ],
      "env": {
        "TRACKYOURTIME_API_TOKEN": "<TRACKYOURTIME_API_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "trackyourtime": {
      "command": "npx",
      "args": [
        "-y",
        "trackyourtime-mcp"
      ],
      "env": {
        "TRACKYOURTIME_API_TOKEN": "<TRACKYOURTIME_API_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "trackyourtime": {
      "command": "npx",
      "args": [
        "-y",
        "trackyourtime-mcp"
      ],
      "env": {
        "TRACKYOURTIME_API_TOKEN": "<TRACKYOURTIME_API_TOKEN>"
      }
    }
  }
}
```

## Tools

- `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

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/track-your-time
