Track Your Time

Track time, manage entries and catalog, and summarize hours on hosted or self-hosted accounts.

Connector by trebeljahr · GitHub account verified by the MCP Registry

IndexedAGPL-3.0Local (stdio)★ 2

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/trebeljahr-trackyourtime

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

Track time, manage entries and catalog, and summarize hours on hosted or self-hosted accounts.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools: 8 read · 7 write · 0 delete
Secrets: 1 (API keys, tokens or passwords)
Install scripts: None found
Runs as: Node.js package

Tools by what they do 15

Read from the source code; the running server may list different tools.

Read 8 · Look things up without changing anything.

get_running_timer
get_token_info
list_clients
list_entries
list_projects
list_tags
list_tasks
summary_report

Write 7 · Create, change, send or run things.

create_client
create_project
create_tag
create_task
log_time_entry
start_timer
stop_timer

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

TRACKYOURTIME_API_TOKEN

Other settings (environment variables or headers).

TRACKYOURTIME_API_URL

Network hosts it talks to 4

api.trackyourtime.dev · found in code
github.com · found in code
ricos.site · found in code
trackyourtime.dev · found in code

Tools (15)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

create_clientCreate a client
Create a client. A colour is assigned when none is given.
create_projectCreate a project
Create a project, optionally under a client (clientId from list_clients), with an hourly rate, a billable default, estimated hours or a budget.
create_tagCreate a tag
Create a tag. Entries can carry several tags, and reports can group by them.
create_taskCreate a task
Create a workspace-wide task, a name for a kind of work that any project's entries can use. Task names are unique per workspace.
get_running_timerGet the running timerread-only
Return the timer currently running in this token's workspace, with how long it has run, or say that none is running.
get_token_infoCheck the connectionread-only
Confirm the MCP server can reach Track Your Time, and show the token's workspace, scopes and whether it may see other members' time and money. Call this first when another tool fails with an authentication error.
list_clientsList clientsread-only
List the workspace's clients. Archived clients are left out unless includeArchived is true.
list_entriesList time entriesread-only
List time entries that overlap a date range, newest first, with project, client and task names. Filter by project, client, task, tag, billable flag, or a text `search` over descriptions. Returns up to `limit` entries (default 100, max 500); pass `nextCursor` back as `cursor` for the next page.
list_projectsList projectsread-only
List projects with their client, hourly rate, total tracked time and budget progress. Narrow to one client with clientId. Archived projects are left out unless includeArchived is true.
list_tagsList tagsread-only
List tags with usage totals. Automation-only hidden tags are excluded unless includeHidden is true.
list_tasksList tasksread-only
List tasks. A task is a workspace-wide kind of work (for example "Design review"), not part of a project: an entry carries a project and a task independently.
log_time_entryLog past time
Create a finished time entry with an explicit start and end, for work that was not timed. `start` and `end` are ISO-8601 timestamps with an offset or Z, and end must be after start.
start_timerStart a timer
Start a timer now (or at `start`). A timer already running in this workspace is stopped first. Use list_projects, list_tasks and list_tags to find ids; pass none of them to track unfiled time. Answers 409 when a timer runs in another workspace this token cannot stop.
stop_timerStop the timer
Stop the timer running in this workspace, now or at `end`. Pass `id` to stop a specific entry; stopping an entry that is already stopped returns it unchanged.
summary_reportSummarise timeread-only
Total, billable time and amount for a date range, broken down by project, client, task or tag (or by day, week or month), plus a daily series. Grouped by tag, each entry counts fully toward every tag it carries, so tag rows can add up to more than the total. Refused when the token's owner may not see other members' money.

Signals

Stars: 2
Forks: 0
Open issues: 0
Last commit (this folder): Oct 23, 2026 (5 days ago)
Last release: Oct 22, 2026 (7 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name: io.github.trebeljahr/trackyourtime
Version: 0.3.0
Auth: API key
Packages: npm trackyourtime-mcp
License: AGPL-3.0
Repository: github.com/trebeljahr/trackyourtime
Website: trackyourtime.dev/docs/mcp/
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry github-graphql