home / mcp / clockify mcp server

Clockify MCP Server

Provides Clockify data access via MCP, enabling time entries, projects, tasks, and workspace management through MCP clients.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "aslamanver-mcp_clockify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp_clockify@latest"
      ],
      "env": {
        "CLOCKIFY_API_KEY": "YOUR_CLOCKIFY_API_KEY_HERE"
      }
    }
  }
}

Clockify MCP Server provides a dedicated bridge between your AI assistants and Clockify, letting you manage time entries, projects, tasks, users, and workspaces through MCP-compatible clients. It centralizes Clockify actions into a single, programmable endpoint you can query from your copilots or automation workflows.

How to use

You connect to the Clockify MCP Server from any MCP-compatible client (such as VS Code, Claude Desktop, or Gemini) and issue high-level commands to manage time tracking data. Practical workflows include creating time entries for specific projects, listing projects across workspaces, retrieving your user profile, and updating or deleting existing time entries. Use the available tools to fetch user info, list workspaces, browse projects, list tasks, and perform CRUD operations on time entries. Each action is performed via the MCP client, which passes your request to the Clockify MCP Server and returns the results.

How to install

{
  "servers": {
    "clockify_mcp": {
      "command": "npx",
      "args": ["-y", "mcp_clockify@latest"],
      "env": {
        "CLOCKIFY_API_KEY": "your-clockify-api-key-here"
      }
    }
  }
}

Additional setup and usage notes

If you prefer a local development setup, you can clone the project, install dependencies, build the project, and run it locally. You will supply your Clockify API key as an environment variable when starting the server so all requests to Clockify are authenticated.

Available tools

get-clockify-user

Retrieve current user profile information from Clockify.

list-clockify-workspaces

List all accessible Clockify workspaces.

list-clockify-projects

List projects within a specific workspace, with optional name filtering.

list-clockify-tasks

List tasks within a specific project.

create-clockify-time-entry

Create a new time entry in Clockify.

update-clockify-time-entry

Update an existing time entry in Clockify.

delete-clockify-time-entry

Delete a time entry from Clockify.

list-clockify-time-entries

List time entries with date filtering.