Teetrack

Official registry Security

Privacy-first time tracking for freelancers. EU-hosted, with an MCP server for AI assistants.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code
claude mcp add --transport http teetrack 'https://teetrack.it/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "teetrack": {
            "type": "http",
            "url": "https://teetrack.it/api/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Teetrack MCP Server
  2. Quick start
  3. Authentication
  4. Tools (35)
  5. Example prompts
  6. About Teetrack

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
  1. Settings → Integrations → Add custom integration
  2. Paste https://teetrack.it/api/mcp
  3. 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.

Tools (35)

GroupCountTools
Timers3start_timer, stop_timer, get_running_timer
Time Entries5list_tracks, get_track, log_time, update_track, delete_track
Projects5list_projects, get_project, create_project, update_project, delete_project
Tags4list_tags, create_tag, update_tag, delete_tag
Clients5list_clients, get_client, create_client, update_client, delete_client
Summaries3get_time_summary, get_project_summary, get_budget_status
Settings3get_user_settings, update_user_settings, get_subscription_usage
Calendar7list_calendar_connections, list_calendar_events, get_calendar_suggestions, confirm_draft_track, bulk_confirm_draft_tracks, dismiss_draft_track, trigger_calendar_sync
Timers
ToolDescription
start_timerStart a new timer (creates a track with no end time). Multiple timers can run concurrently. Returns the new running track.
stop_timerStop 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_timerGet all currently running timers (tracks with no end time). Returns an array (empty if none active).
Time Entries
ToolDescription
list_tracksList time tracking entries with optional filters and pagination. Returns tracks sorted by start time (newest first).
get_trackGet a single time tracking entry by its ID.
log_timeLog a completed time entry with both start and end times.
update_trackUpdate an existing time tracking entry. Only provided fields are changed.
delete_trackDelete a time tracking entry by ID.
Projects
ToolDescription
list_projectsList all projects with optional pagination.
get_projectGet a single project by its ID, including billing and budget configuration.
create_projectCreate a new project.
update_projectUpdate an existing project. Only provided fields are changed.
delete_projectDelete a project by ID.
Tags
ToolDescription
list_tagsList all tags with their track counts and total tracked seconds.
create_tagCreate a new tag.
update_tagUpdate an existing tag. Only provided fields are changed.
delete_tagDelete a tag by ID.
Clients
ToolDescription
list_clientsList all clients.
get_clientGet a single client by ID.
create_clientCreate a new client.
update_clientUpdate an existing client. Only provided fields are changed.
delete_clientDelete a client by ID.
Summaries
ToolDescription
get_time_summaryGet total tracked time broken down by: all time, this year, this month, and today. Returns seconds for each period.
get_project_summaryGet top projects with hours, billable amounts, and day counts. Useful for understanding where time is being spent.
get_budget_statusGet budget status for all projects with budgets configured. Shows tracked vs. budgeted hours/amounts and whether over budget.
Settings
ToolDescription
get_user_settingsGet the current user's display and rounding settings.
update_user_settingsUpdate user settings. Only provided fields are changed.
get_subscription_usageGet current subscription tier info, feature list, limits, and usage counts.
Calendar
ToolDescription
list_calendar_connectionsList all connected calendar accounts (Google, Outlook, iCal). Returns provider, account email, sync status, and auto-import settings.
list_calendar_eventsList calendar events within a date range from all enabled calendar connections. Excludes all-day events and cancelled events.
get_calendar_suggestionsList all pending draft time entries imported from calendar events. Returns drafts with their current project assignment for review.
confirm_draft_trackConfirm 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_tracksConfirm multiple draft time entries at once. Returns the count of confirmed entries.
dismiss_draft_trackDismiss a draft time entry imported from a calendar event. The event will not be re-imported in future syncs.
trigger_calendar_syncTrigger 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

Frequently asked questions

What is Teetrack?

Privacy-first time tracking for freelancers. EU-hosted, with an MCP server for AI assistants.

How do I install Teetrack?

It runs as a remote server. In Claude Code: claude mcp add --transport http teetrack 'https://teetrack.it/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Teetrack need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Teetrack open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Teetrack?

It is published by HolyMarcell. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.