Clockify MCP server

Connect Clockify to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Clockify MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the delete tag tool in Clockify
  • Use the create project tool in Clockify
  • Use the stop timer tool in Clockify
  • Use the get workspace users tool in Clockify
  • Use the create invoice tool in Clockify
  • Use the delete time entry tool in Clockify

Supported Tools

delete_tag

Delete Tag

Delete a tag from the Clockify workspace. Call get_workspaces to discover the workspace ID.

create_project

Create Project

Create a new project in the Clockify workspace. Set name, client, visibility, billing, color, and notes. Call get_workspaces to discover the workspace ID.

stop_timer

Stop Timer

Stop the currently running timer for a user. If no userId is provided, stops the timer for the authenticated user. Optionally specify a custom end time. Call get_workspaces to discover the workspace ID.

get_users

Get Workspace Users

List users in the Clockify workspace. Filter by email, name, or status. Returns user IDs, names, email addresses, and status. Call get_workspaces to discover the workspace ID.

create_invoice

Create Invoice

Create a new invoice in Clockify. Set client, dates, line items, and billing details. Call get_workspaces to discover the workspace ID.

delete_time_entry

Delete Time Entry

Delete a time entry from Clockify. This permanently removes the time entry. Call get_workspaces to discover the workspace ID.

delete_invoice

Delete Invoice

Delete an invoice from Clockify. Call get_workspaces to discover the workspace ID.

get_current_user

Get Current User

Get the profile of the currently authenticated user, including their default workspace and settings.

update_invoice

Update Invoice

Update an existing invoice in Clockify. Modify status, dates, or notes, and optionally replace all line items. Use this to send, mark as paid, or void invoices. Line-item replacement uses multiple requests and may be partially applied if a request fails. Call get_workspaces to discover the workspace ID.

update_time_off_request_status

Update Time Off Request Status

Approve or reject a time off request in Clockify. Withdrawal is not supported by this status endpoint. Call get_workspaces to discover the workspace ID.

get_time_entries

Get Time Entries

Retrieve time entries for a user in the workspace. Filter by date range, project, task, tags, or description. Returns entries sorted by start time. If no userId is provided, retrieves entries for the authenticated user. Call get_workspaces to discover the workspace ID.

update_project

Update Project

Update an existing project in Clockify. Modify its name, client, visibility, billing, color, notes, or archive status. Active projects must be archived before deletion. Call get_workspaces to discover the workspace ID.

create_task

Create Task

Create a new task within a Clockify project. Tasks can have assignees, estimates, billable status, and custom rates. Call get_workspaces to discover the workspace ID.

delete_client

Delete Client

Delete a client from the Clockify workspace. Call get_workspaces to discover the workspace ID.

update_task

Update Task

Update an existing task in a Clockify project. Modify name, assignees, billable status, estimate, or status. Call get_workspaces to discover the workspace ID.

update_time_entry

Update Time Entry

Update an existing time entry in Clockify. Modify its start/end times, description, project, task, tags, or billable status. The start time is always required by the API. Call get_workspaces to discover the workspace ID.

create_time_entry

Create Time Entry

Create a new time entry or start a timer in Clockify. Supports manual time entries with start/end times, or starting a running timer by omitting the end time. Can assign entries to projects, tasks, and tags, and set billable status. Call get_workspaces to discover the workspace ID.

generate_summary_report

Generate Summary Report

Generate a summary report from Clockify. Aggregates time entry data by project, user, client, task, tag, or time period. Useful for getting totals without individual entry details. Call get_workspaces to discover the workspace ID.

get_tags

Get Tags

List tags in the Clockify workspace. Filter by name or archived status. Call get_workspaces to discover the workspace ID.

get_projects

Get Projects

List projects in the Clockify workspace. Filter by name, archived status, client, or billable status. Supports pagination. Call get_workspaces to discover the workspace ID.

delete_project

Delete Project

Delete a project from Clockify. The project must be archived before it can be deleted. Call get_workspaces to discover the workspace ID.

get_user_groups

Get User Groups

List user groups in the Clockify workspace. Filter by name. Call get_workspaces to discover the workspace ID.

update_tag

Update Tag

Update an existing tag in Clockify. Modify its name or archive status. Call get_workspaces to discover the workspace ID.

create_expense

Create Expense

Create a new expense entry in Clockify. Assign to a project, set category, amount, and billable status. Call get_workspaces to discover the workspace ID.

get_tasks

Get Tasks

List tasks for a project in Clockify. Filter by name or active status. Supports pagination. Call get_workspaces to discover the workspace ID.

create_user_group

Create User Group

Create a new user group in the Clockify workspace. Groups can be used for project membership and scheduling. Call get_workspaces to discover the workspace ID.

delete_task

Delete Task

Delete a task from a Clockify project. Call get_workspaces to discover the workspace ID.

create_client

Create Client

Create a new client in the Clockify workspace. Clients can be associated with projects for billing and reporting. Call get_workspaces to discover the workspace ID.

get_clients

Get Clients

List clients in the Clockify workspace. Filter by name or archived status. Call get_workspaces to discover the workspace ID.

get_time_off_requests

Get Time Off Requests

List time off requests in the workspace. Filter by status, users, and date range. Call get_workspaces to discover the workspace ID.

get_invoices

Get Invoices

List invoices in the Clockify workspace. Filter by status. Returns invoice summaries with amounts and dates. Call get_workspaces to discover the workspace ID.

create_time_off_request

Create Time Off Request

Submit a new time off request in Clockify. Requires a time off policy, date range, and optional notes. Call get_workspaces to discover the workspace ID.

create_tag

Create Tag

Create a new tag in the Clockify workspace. Tags are used to categorize and filter time entries. Call get_workspaces to discover the workspace ID.

get_time_off_policies

Get Time Off Policies

List time off policies configured in the Clockify workspace. Returns policy names and settings. Call get_workspaces to discover the workspace ID.

get_workspace

Get Workspace

Get details about the selected Clockify workspace, including settings, features, and billing info. Call get_workspaces to discover the workspace ID.

generate_detailed_report

Generate Detailed Report

Generate a detailed time entry report from the Clockify Reports API. Filter by date range, users, projects, clients, tasks, tags, billable status, and more. Returns individual time entries with full details. Call get_workspaces to discover the workspace ID.

update_user_group

Update User Group

Update a user group name, or add/remove users from the group. Call get_workspaces to discover the workspace ID.

delete_user_group

Delete User Group

Delete a user group from the Clockify workspace. Call get_workspaces to discover the workspace ID.

delete_expense

Delete Expense

Delete an expense entry from Clockify. Call get_workspaces to discover the workspace ID.

update_client

Update Client

Update an existing client in Clockify. Modify name, email, address, notes, or archive status. Call get_workspaces to discover the workspace ID.

get_project

Get Project

Get a Clockify project by ID, including visibility, archive state, and client assignment. Call get_workspaces to discover the workspace ID.

get_time_entry

Get Time Entry

Get a specific Clockify time entry by ID, including timer state, dates, project, task, and tags. Call get_workspaces to discover the workspace ID.

get_workspaces

Get Workspaces

List workspaces accessible to the authenticated Clockify user. Use a returned workspaceId in workspace tools.

Connect Clockify to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Clockify in Metorial. In your Metorial portal, enable the Clockify MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Clockify tools.

Run Clockify through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Clockify and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Clockify tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Clockify

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.

Technical notes for Clockify

Track work hours and timers, manage projects, tasks, clients, tags, and user groups, and generate detailed or summary reports. Discover workspaces and inspect user profiles, projects, and time entries. Manage invoices, create expenses with receipts, and submit or review time off requests.

Frequently asked questions

Common questions about connecting Clockify to AI agents with Metorial.

  1. How many tools does the Clockify MCP server have?
    The Clockify MCP server exposes 43 tools, including Delete Tag, Create Project, Stop Timer. Each one is governed and traced through Metorial.
  2. Clockify exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Clockify MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Clockify and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Clockify MCP server yourself or use the hosted gateway.

Connect Clockify to production AI agents

See how Metorial gives your team governed access to Clockify, with tracing and security controls built in.