@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

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