Teetrack MCP Server
Privacy-first time tracking for freelancers. EU-hosted, with an MCP server for AI assistants.
Teetrack's remote MCP (Model Context Protocol) server lets AI assistants like Claude, ChatGPT, and Microsoft Copilot operate your time tracker in chat: start and stop timers, log entries, manage projects and clients, review calendar-imported drafts, and answer questions like "how many billable hours did I log for Acme this month?"
Connect URL:
https://teetrack.it/api/mcp
No install, no API keys, no local process — it's a hosted server (Streamable HTTP) with OAuth. Point your MCP client at the URL above and log in once.
Quick start
claude.ai / Claude Desktop
- Settings → Integrations → Add custom integration
- Paste
https://teetrack.it/api/mcp
- A browser window opens with a normal Teetrack login — approve once, and the connection persists.
Full walkthrough: https://teetrack.it/guides/mcp/claude
ChatGPT
ChatGPT connects via its connectors/apps settings using the same URL. Step-by-step: https://teetrack.it/guides/mcp/chatgpt
Microsoft Copilot
Copilot connects using the same URL. Step-by-step: https://teetrack.it/guides/mcp/copilot
Any other MCP client
Any client that supports remote MCP servers with OAuth can connect to https://teetrack.it/api/mcp. You need a Teetrack account — the free plan works.
Authentication
The first connection opens a standard browser login to your Teetrack account (OAuth). You approve it once; after that the client holds its own authorized connection to your account. No tokens to copy, nothing stored in config files. The tools a client sees are filtered by the scopes granted during that OAuth approval, so some connections may expose a subset of the full list below.
| Group | Count | Tools |
|---|
| Timers | 3 | start_timer, stop_timer, get_running_timer |
| Time Entries | 5 | list_tracks, get_track, log_time, update_track, delete_track |
| Projects | 5 | list_projects, get_project, create_project, update_project, delete_project |
| Tags | 4 | list_tags, create_tag, update_tag, delete_tag |
| Clients | 5 | list_clients, get_client, create_client, update_client, delete_client |
| Summaries | 3 | get_time_summary, get_project_summary, get_budget_status |
| Settings | 3 | get_user_settings, update_user_settings, get_subscription_usage |
| Calendar | 7 | list_calendar_connections, list_calendar_events, get_calendar_suggestions, confirm_draft_track, bulk_confirm_draft_tracks, dismiss_draft_track, trigger_calendar_sync |
Timers
| Tool | Description |
|---|
start_timer | Start a new timer (creates a track with no end time). Multiple timers can run concurrently. Returns the new running track. |
stop_timer | Stop a running timer by setting its end time to now. If no id is given, stops the most recently started timer. Returns the stopped track. |
get_running_timer | Get all currently running timers (tracks with no end time). Returns an array (empty if none active). |
Time Entries
| Tool | Description |
|---|
list_tracks | List time tracking entries with optional filters and pagination. Returns tracks sorted by start time (newest first). |
get_track | Get a single time tracking entry by its ID. |
log_time | Log a completed time entry with both start and end times. |
update_track | Update an existing time tracking entry. Only provided fields are changed. |
delete_track | Delete a time tracking entry by ID. |
Projects
| Tool | Description |
|---|
list_projects | List all projects with optional pagination. |
get_project | Get a single project by its ID, including billing and budget configuration. |
create_project | Create a new project. |
update_project | Update an existing project. Only provided fields are changed. |
delete_project | Delete a project by ID. |
| Tool | Description |
|---|
list_tags | List all tags with their track counts and total tracked seconds. |
create_tag | Create a new tag. |
update_tag | Update an existing tag. Only provided fields are changed. |
delete_tag | Delete a tag by ID. |
Clients
| Tool | Description |
|---|
list_clients | List all clients. |
get_client | Get a single client by ID. |
create_client | Create a new client. |
update_client | Update an existing client. Only provided fields are changed. |
delete_client | Delete a client by ID. |
Summaries
| Tool | Description |
|---|
get_time_summary | Get total tracked time broken down by: all time, this year, this month, and today. Returns seconds for each period. |
get_project_summary | Get top projects with hours, billable amounts, and day counts. Useful for understanding where time is being spent. |
get_budget_status | Get budget status for all projects with budgets configured. Shows tracked vs. budgeted hours/amounts and whether over budget. |
Settings
| Tool | Description |
|---|
get_user_settings | Get the current user's display and rounding settings. |
update_user_settings | Update user settings. Only provided fields are changed. |
get_subscription_usage | Get current subscription tier info, feature list, limits, and usage counts. |
Calendar
| Tool | Description |
|---|
list_calendar_connections | List all connected calendar accounts (Google, Outlook, iCal). Returns provider, account email, sync status, and auto-import settings. |
list_calendar_events | List calendar events within a date range from all enabled calendar connections. Excludes all-day events and cancelled events. |
get_calendar_suggestions | List all pending draft time entries imported from calendar events. Returns drafts with their current project assignment for review. |
confirm_draft_track | Confirm a draft time entry imported from a calendar event. Sets draft=false, making it count toward summaries. Use update_track first to change description or project. |
bulk_confirm_draft_tracks | Confirm multiple draft time entries at once. Returns the count of confirmed entries. |
dismiss_draft_track | Dismiss a draft time entry imported from a calendar event. The event will not be re-imported in future syncs. |
trigger_calendar_sync | Trigger a calendar sync. If connection_id is provided, syncs that specific connection. Otherwise syncs all enabled connections. Rate limited: once per connection per 5 minutes. |
Example prompts
- "Start a timer for the Acme website redesign — homepage copy."
- "Stop the timer, and log 2 hours for yesterday afternoon on the same project."
- "How many billable hours did I log for Acme this month, and how much of the retainer budget is left?"
- "Show me my pending calendar drafts and confirm everything that's a client meeting."
- "Which project ate most of my week?"
About Teetrack
Teetrack is single-user time tracking and billing for freelancers and consultants. Track hours per client and project, monitor budgets, export PDF/CSV timesheets. EU-hosted (Hetzner), GDPR-first, no screenshots or surveillance. Free plan, €4/mo Business.
Every plan is single-user — one seat, one flat price. Built and run by one person; every support request is answered by the person who wrote the code.
Get started: https://teetrack.it