Clockify

Clockify MCP Server provides a focused bridge between Clockify and your MCP client. It lets you automate time entries, organize projects and tasks, manage clients and tags, and generate detailed reports through a standardized, easy-to-use interface.

How to use

You connect Clockify MCP Server to your MCP client to manage time tracking from your assistant or automation workflows. Use it to create, read, update, delete, and stop time entries; manage projects, tasks, clients, and tags; and generate detailed or summarized reports with filtering and pagination. Start by configuring your MCP client to point to the Clockify MCP Server, then issue natural-language style prompts like creating a time entry for a specific project, listing your workspaces, or pulling this week’s entries.

How to install

Prerequisites: you need Node.js 18 or higher and a Clockify account with API access. You also need a Clockify API key to authorize requests.

npm install -g @ratheesh-aot/clockify-mcp-server

Available tools

get_current_user

Get current user information from Clockify and return user details such as name, email, and role.

get_workspaces

List all workspaces accessible to the authenticated user, including workspace names and IDs.

get_workspace_users

Retrieve all users within a specific workspace with roles and contact info.

create_time_entry

Create a new time entry with optional associations to a project or task, including start and end times and description.

get_time_entries

Fetch time entries with filters like workspace, date range, project, task, client, and tags; supports pagination.

update_time_entry

Modify details of an existing time entry, such as description, times, or associations.

delete_time_entry

Remove a time entry from the workspace.

stop_time_entry

Stop a currently running time entry to finalize its duration.

create_project

Create a new project with optional client association, billable status, visibility, and color.

get_projects

List projects with optional filtering and pagination to navigate large sets.

get_project

Retrieve detailed information for a specific project.

update_project

Modify project attributes such as name, client, billing, and color.

delete_project

Remove a project from the workspace.

create_task

Create a task within a project to track work items and stages.

get_tasks

List tasks with filters and pagination for manageable viewing.

get_task

Get detailed information for a specific task.

update_task

Update task details like name, status, or due date.

delete_task

Delete a task from its project.

create_client

Create a new client in the workspace with optional contact info.

get_clients

List clients with filtering options to locate specific accounts.

update_client

Modify client information such as name or contact details.

delete_client

Remove a client from the workspace.

create_tag

Create new tags to categorize time entries for reporting and filtering.

get_tags

Retrieve available tags for use in time entries and reports.

update_tag

Rename or modify details of an existing tag.

delete_tag

Remove a tag from the system.

get_detailed_report

Generate a comprehensive report with filters and breakdowns by project, client, task, or tag.

get_summary_report

Produce summarized reports with grouping options for quick insights.