Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@TrackingTime MCP Serverstart a timer for the UI Design task"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
TrackingTime MCP Server
An MCP (Model Context Protocol) server that connects AI assistants like Claude to the TrackingTime API v4. Manage projects, tasks, time tracking, staff assignments, and customers through natural language.
Quick Start
1. Get your TrackingTime credentials
App Password: TrackingTime → Manage → User Settings → Apps & Integrations → create a new App Password
Account ID: Visible in your TrackingTime URL when logged in, or in account settings
2. Add to your AI assistant
Claude Code:
claude mcp add trackingtime -e TT_APP_PASSWORD=your-app-password -e TT_ACCOUNT_ID=your-account-id -- npx trackingtime-mcpClaude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"trackingtime": {
"command": "npx",
"args": ["trackingtime-mcp"],
"env": {
"TT_APP_PASSWORD": "your-app-password",
"TT_ACCOUNT_ID": "your-account-id"
}
}
}
}Restart your assistant after adding.
Alternative: Install from source
If you prefer to clone and build locally:
git clone https://github.com/ficus33/trackingtime-mcp.git
cd trackingtime-mcp
npm install
npm run build
cp .env.example .env # then edit .env with your credentialsThen point your assistant at the local build:
claude mcp add trackingtime -- node /path/to/trackingtime-mcp/dist/index.jsTools
Projects
Tool | Description |
| List projects (filter: ACTIVE/ARCHIVED/ALL/FOLLOWING) |
| List only project IDs (lightweight, for batch operations) |
| Search projects and tasks by keyword |
| Create a new project |
| Edit project name, customer, or service |
| Set favorite, default view, show closed tasks |
| Get single project with detail flags |
| Get accumulated time for multiple projects |
| See which staff are on a project |
| Archive a project (reversible) |
| Reopen an archived project |
| Permanently delete a project |
| Merge one project into another |
Tasks
Tool | Description |
| List tasks (filter: ACTIVE/ARCHIVED/ALL/TRACKING) |
| Create a task with assignees, due date, estimate |
| Edit task or reassign staff |
| Get single task details |
| Get accumulated times for multiple tasks |
| Search tasks by name within projects |
| Reorder tasks by sort index |
| Bulk import tasks with preview mode |
| Mark a task as complete |
| Reopen a completed task |
| Delete a task |
Time Tracking
Tool | Description |
| Start a timer on a task |
| Stop a running timer |
Time Entries
Tool | Description |
| List entries by user/project/customer/task + date range |
| Add a manual time entry (duration in seconds) |
| Get a single time entry |
| Edit a time entry |
| Delete a time entry |
| Summary of hours per user per day |
| Export as CSV |
| Flag entries as billed |
| Unflag billed entries |
Users & Staff
Tool | Description |
| List all staff (find user IDs) |
| Get single user details |
| Update user profile |
| List a user's tasks grouped by project |
| See what a user is currently tracking |
| All projects and tasks assigned to a user |
| List projects assigned to a user |
| Assign staff to projects |
| Remove staff from projects |
| Deactivate a user (admin only) |
| Reactivate an archived user |
| Invite people by email |
Customers
Tool | Description |
| List customers (filter: ACTIVE/ARCHIVED/ALL) |
| Get single customer details |
| Create a new customer |
| Edit customer details |
| Permanently delete a customer |
| Archive a customer (reversible) |
| Reactivate an archived customer |
Reducing tool count
All 54 tools are active by default. If you find this adds too much context for your AI assistant, you can clone the repo, comment out tools you don't need in src/tools.ts with /* */, and run npm run build to create a slimmer build.
Testing
Use MCP Inspector to test tools interactively:
npx @modelcontextprotocol/inspector npx trackingtime-mcpAPI Notes
A few TrackingTime API quirks to be aware of:
durationandaccumulated_timeare in secondsestimated_timeandworked_hoursare in hoursTime entries are called "events" in the API
Starting a timer when one is already running returns error 502 — use
stop_running_task=trueto auto-stop the current timerDates use
YYYY-MM-DD, datetimes useyyyy-MM-dd HH:mm:ss
Auth
This server uses TrackingTime's App Password authentication. Your real password is never stored. The App Password is sent as HTTP Basic auth (API_TOKEN:<app_password>) over SSL.
If an App Password is compromised, revoke it in TrackingTime and create a new one — no need to change your account password.
License
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.