Clockify MCP Server
by inakianduaga
The Clockify MCP Server allows LLMs to interact with your Clockify workspace for time-tracking automation and reporting. It enables integration with LLMs to automate, summarize, or analyze your time-tracking data.
Last updated: N/A
What is Clockify MCP Server?
The Clockify MCP Server is a tool that allows Large Language Models (LLMs) like Cursor or Claude to interact with your Clockify workspace. It acts as a bridge, enabling you to automate time-tracking tasks, generate reports, and analyze your time data using LLMs.
How to use Clockify MCP Server?
To use the Clockify MCP Server, you need to configure your LLM's settings (e.g., Cursor or Claude) to connect to the server. This typically involves adding a configuration block to your LLM's settings.json file, specifying the server's command (using Docker), arguments (including your Clockify API key), and other settings. You will also need to obtain a Clockify API key from your Clockify profile.
Key features of Clockify MCP Server
listProjects: List all projects for the authenticated user
getTimeEntries: List time entries for the authenticated user (with optional date filters)
addTimeEntry: Add time entries to a project
listUsers: List all users in the workspace
getUserTimeEntries: List time entries for any user (with optional date filters)
getSummaryReport: Get a summary report of hours by user/project for a date range
Use cases of Clockify MCP Server
Automating time entry creation based on tasks performed
Generating summaries of time spent on different projects
Analyzing time-tracking data to identify areas for improvement
Creating custom reports on time usage by user, project, or date range
FAQ from Clockify MCP Server
How do I obtain a Clockify API key?
How do I obtain a Clockify API key?
Log in to your Clockify account, click on your profile icon, select Profile, scroll down to the API section, and generate or copy your existing key.
How do I configure the MCP server for Cursor/Claude?
How do I configure the MCP server for Cursor/Claude?
Add the provided JSON configuration block to your Cursor or Claude settings.json file, replacing YOUR_API_KEY with your actual Clockify API key.
What is the Docker image URL?
What is the Docker image URL?
The Docker image URL is ghcr.io/inakianduaga/clockify-mcp:latest.
How do I pull the Docker image?
How do I pull the Docker image?
Use the command docker pull ghcr.io/inakianduaga/clockify-mcp:latest.
What are the prerequisites for using this server?
What are the prerequisites for using this server?
You need a Clockify account, an API key, and Docker installed on your system.