Skip to content
MCP server

Track Your Time

Start timers, log hours and summarise time in Track Your Time from your assistant

Runs locallyStatus and history
Install
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-mcp

Add 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.Required
  • TRACKYOURTIME_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

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media