io.github.trebeljahr由 GitHub 账号 trebeljahr 发布v0.3.0更新于 Oct 30, 2026
Track time, manage entries and catalog, and summarize hours on hosted or self-hosted accounts.
Track Your Time 的本地 MCP 服务器，让助手启动和停止计时器、补录工时、管理客户、项目、任务与标签，并生成汇总报表。
Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。
参照 仓库 中的启动说明。
Start a timer, record missed hours, or ask for a report from your MCP client. Use the hosted Track Your Time service or your own server.
Requires Node.js 24 or newer and a Track Your Time API token.
Create a token in Settings → Integrations → API tokens. Select only the scopes you need. The token belongs to one workspace.
Add this entry to your MCP client's configuration:
For self-hosting, also set TRACKYOURTIME_API_URL to your instance's origin, such as https://time.example.com.
Treat the API token like a password. MCP client configuration files usually store it in plain text. Revoke the token in Track Your Time when you stop using it.
The server reads your token's scopes and offers the tools those scopes permit:
There are no invoice tools or hosted MCP endpoint. This package uses stdio and calls your server's REST API.
Licensed under AGPL-3.0-or-later. The published bundle includes source maps with the bundled TypeScript source.
来源：packages/mcp/README.md，提交 dcd102e
Check the connection
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.
无需输入参数。
Get the running timer
Return the timer currently running in this token's workspace, with how long it has run, or say that none is running.
无需输入参数。
Start 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.
starttagIdstaskIdbillableclientIdtimeZoneprojectIddescriptionoperationIdStop 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.
idendoperationIdLog 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.
end必填start必填tagIdstaskIdbillableclientIdtimeZoneprojectIddescriptionoperationIdList time entries
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.
to必填from必填limitcursorsearchtagIdstaskIdsbillabletimeZoneclientIdsprojectIdsList clients
List the workspace's clients. Archived clients are left out unless includeArchived is true.
includeArchivedList projects
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.
clientIdincludeArchivedList tasks
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.
includeArchivedList tags
List tags with how many entries carry each one and their total time.
includeArchivedCreate a client
Create a client. A colour is assigned when none is given.
name必填colorbillinginvoiceLocaleCreate 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.
name必填colorclientIdhourlyRatebudgetAmountidleBehaviorbudgetCurrencyestimatedHoursbillableDefaultCreate 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.
name必填colorCreate a tag
Create a tag. Entries can carry several tags, and reports can group by them.
name必填colorSummarise time
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.
to必填from必填searchtagIdsgroupBy必填taskIdsbillabletimeZoneclientIdsmemberIdsprojectIds已满足适用检查项的 90%
该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。
请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。
{ "mcpServers": { "trackyourtime": { "command": "npx", "args": ["-y", "trackyourtime-mcp"], "env": { "TRACKYOURTIME_API_TOKEN": "tt_your_token" } } }}