tracegazer/clockify-mcp

> A Model Context Protocol server for the Clockify **time-tracking API**.
Give your AI assistant access to your Clockify data — query workspaces, projects, and time entries, generate reports, log hours, and manage clients, invoices, and more — all through natural language.
**112 tools** across 18 domains. Read-only by default, with optional write operations behind explicit opt-in.
Install in one click
The easiest way to use this server with **Claude Desktop** (and other MCPB-compatible clients) is the prebuilt bundle:
**➡️ Download clockify-mcp.mcpb** — then double-click it. Claude Desktop opens the installer, prompts for your Clockify API key, and you're done. No Python, no npx/uvx, no config files.
The .mcpb is attached to every GitHub Release and mirrored on Smithery. Prefer a package manager or container? See Quick start below.
What can it do?
**48 read-only tools** are available today (Phase 0–8b — 18 domains). 64 write tools (create/update/delete across clients, projects, tasks, tags, time entries, holidays, expenses, and expense categories, plus time-off policy/request management, approval submit/resubmit/update, custom-field create/update/delete and project assignment, scheduling assignment management, invoice and payment management, shared-report management, and webhook create/update/delete/token) register when you set CLOCKIFY_ACCESS_MODE=full (or the back-compat CLOCKIFY_ENABLE_WRITES=true). A middle time-tracking mode exposes only the time-entry writes for logging hours — see Access modes.
| Domain | Tools | Tool names |
|--------|------:|------------|
| **Workspaces** | 3 | get_current_user, list_workspaces, get_workspace |
| **Users** | 3 | list_users, get_user_member_profile, find_user_team_manager |
| **Groups** | 1 | list_user_groups |
| **Clients** | 2 | list_clients, get_client |
| **Projects** | 2 | list_projects, get_project |
| **Tasks** | 2 | list_tasks, get_task |
| **Tags** | 2 | list_tags, get_tag |
| **Time entries** | 2 | list_time_entries, get_time_entry |
| **Reports** | 6 | generate_detailed_report, generate_summary_report, generate_weekly_report, generate_attendance_report‡, generate_expense_report‡, export_report (PDF/CSV/XLSX to a file) |
| **Shared reports** | 2 | list_shared_reports, get_shared_report |
| **Time off**† | 5 | list_time_off_policies, get_time_off_policy, list_time_off_balances_by_policy, list_time_off_balances_by_user, list_time_off_requests |
| **Holidays**† | 2 | list_holidays, list_holidays_in_period |
| **Expenses**† | 4 | list_expenses, get_expense, list_expense_categories, download_expense_receipt |
| **Approvals**† | 1 | list_approval_requests |
| **Custom fields**† | 2 | list_workspace_custom_fields, list_project_custom_fields |
| **Scheduling**† | 3 | list_scheduled_assignments, get_project_scheduling_totals, get_user_scheduling_totals |
| **Invoices**† | 3 | list_invoices, get_invoice, get_invoice_payments |
| **Webhooks**† | 3 | list_webhooks, get_webhook, get_webhook_logs |
† **Time off**, **Holidays**, **Expenses**, **Approvals**, **Custom fields**, **Scheduling**, **Invoices**, and **Webhooks** are paid Clockify features — these tools error (HTTP 402/403/404) on plans without them.
‡ generate_attendance_report and generate_expense_report (and export_report for those two types) need the workspace's attendance/Expenses add-ons; the time-based reports (detailed/summary/weekly) and shared reports work on the free plan.
**Write tools** (opt-in — set CLOCKIFY_ACCESS_MODE=full):
| Domain | Tools | Tool names |
|--------|------:|------------|
| **Clients** | 3 | create_client, update_client, delete_client |
| **Projects** | 3 | create_project, update_project, delete_project |
| **Tasks** | 3 | create_task, update_task, delete_task |
| **Tags** | 3 | create_tag, update_tag, delete_tag |
| **Time entries** | 7 | create_time_entry, update_time_entry, delete_time_entry, duplicate_time_entry, bulk_update_time_entries, create_time_entry_for_user, stop_running_timer |