Use Teetrack with Claude
Connect Teetrack to Claude.ai, Claude Desktop, or Claude Code to manage your time tracking with natural language. Teetrack is not listed in any marketplace — you connect it by entering the MCP server URL manually. Claude has built-in MCP support with OAuth authentication. Once connected, you can ask Claude to start timers, log time, manage projects, create invoices, and more — all in a natural conversation.
Prerequisites
- A Teetrack account at teetrack.it (free or paid)
- Claude.ai (web), Claude Desktop app, or Claude Code CLI
Setup
Option A: Claude.ai (Web)
Important: There is no "Connectors" page and you cannot search for Teetrack in Claude.ai. You add it manually as a custom MCP integration. 1. Go to claude.ai and log in 2. Open Settings (click your profile icon → Settings) 3. Click "Integrations" in the left sidebar 4. Click "Add custom integration" (or "Add more") 5. Enter the MCP server URL shown below and confirm 6. Claude will open a browser window for you to log in to Teetrack and approve permissions 7. Done — you can now use Teetrack tools in your conversations
https://teetrack.it/api/mcp
Option B: Claude Desktop
Open your Claude Desktop config file and add the Teetrack MCP server. Restart Claude Desktop after saving. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"teetrack": {
"url": "https://teetrack.it/api/mcp"
}
}
}Option C: Claude Code (CLI)
If you use Claude Code, add a .mcp.json file to your project root or home directory:
{
"mcpServers": {
"teetrack": {
"type": "url",
"url": "https://teetrack.it/api/mcp"
}
}
}Authorize in your browser
When Claude connects to Teetrack for the first time, it will open your browser for OAuth authorization. Log in to your Teetrack account and approve the requested permissions. This is a one-time step — Claude will remember the connection.
Alternative: Manual token setup
If OAuth does not work in your environment, you can use a personal API token instead. Generate one under Settings → MCP Integration in your Teetrack account and use this config:
{
"mcpServers": {
"teetrack": {
"url": "https://teetrack.it/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}Verify It Works
After connecting, verify by asking Claude:
“What Teetrack tools do you have available?”
Workflow Examples
Here are real-world prompts you can use with Claude to manage your time tracking end-to-end:
Create a client
“Create a new client called Acme Corp with email billing@acme.com and an hourly rate of 150 USD”
Create a project
“Create a project called Website Redesign with color #3B82F6, enable billing at $150/hr, and assign it to Acme Corp”
Create tags
“Create tags for "design" (blue), "meeting" (orange), and "development" (green)”
Start a timer
“Start a timer for "Homepage wireframes" on the Website Redesign project, tagged design”
Stop a timer
“Stop my running timer”
Log past time
“Log 2 hours yesterday 10am-12pm for "Design review meeting" on Website Redesign, tagged meeting”
List tracks
“Show all my tracks from this week on Website Redesign”
Time summary
“How much time have I tracked today? And this month?”
Project summary
“Give me a summary of my top projects this month with billable amounts”
Budget check
“How's the budget looking on Website Redesign?”
Generate invoice
“Generate an invoice from all billable tracks on Website Redesign this month for Acme Corp”
Mark sent & export
“Mark invoice INV-001 as sent and export it as CSV”
Tips for Best Results
- Be specific with project and client names — Claude will match them against your existing data.
- Use natural date references like "yesterday", "this week", or "last Monday" — Claude understands relative dates.
- Ask for summaries before generating invoices so you can review what will be included.
- Review invoice drafts before marking as sent — sent invoices are locked and cannot be edited.
- Ask Claude to confirm before destructive actions like deleting tracks or revoking invoices.
On this page
AI Assistants