Skip to main content
Glama
ivanherula
by ivanherula

@ivanherula/clockify-mcp-server

An MCP (Model Context Protocol) server for Clockify time tracking. Exposes Clockify functionality as tools that Claude and other MCP-compatible LLM clients can invoke.

Installation

npx @ivanherula/clockify-mcp-server

Or install globally:

npm install -g @ivanherula/clockify-mcp-server
clockify-mcp-server

Related MCP server: Clockify MCP Server

Environment Variables

Variable

Required

Description

CLOCKIFY_API_KEY

Yes

Your Clockify API key (found in Profile Settings → API)

CLOCKIFY_WORKSPACE_ID

No

Override workspace ID. If omitted, the first workspace is used automatically.

Configuration

Claude Desktop (claude_desktop_config.json)

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "clockify": {
      "command": "npx",
      "args": ["-y", "@ivanherula/clockify-mcp-server@latest"],
      "env": {
        "CLOCKIFY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code (claude.json)

{
  "mcpServers": {
    "clockify": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@ivanherula/clockify-mcp-server@latest"
      ],
      "env": {
        "CLOCKIFY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Local development / testing

{
  "mcpServers": {
    "clockify": {
      "command": "node",
      "args": ["/path/to/clockify-mcp-server/build/index.js"],
      "env": {
        "CLOCKIFY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

Tool

Description

get_workspaces

List all workspaces

get_current_user

Get authenticated user info

get_projects

List projects (filter by name, archived; paginated)

get_clients

List clients (filter by name, archived; paginated)

get_tags

List tags (filter by name, archived; paginated)

get_time_entries

List time entries with optional date range filter

get_current_timer

Get the currently running timer (null if none)

create_time_entry

Create a time entry; omit end to start a live timer

stop_timer

Stop the running timer with an end time

update_time_entry

Full replace of a time entry (requires start)

delete_time_entry

Delete a time entry by ID

Testing with MCP Inspector

CLOCKIFY_API_KEY=your_key npx @modelcontextprotocol/inspector node build/index.js

Opens at http://localhost:5173 where you can interactively test all tools.

License

MIT

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ivanherula/clockify-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server