npm package: @honeyfield/clockify-mcp
Description: MCP Server for Clockify Time Tracking API
Author: Honeyfield
Latest version: 1.0.4

# @honeyfield/clockify-mcp

MCP Server for Clockify Time Tracking API with full API coverage.

## Installation

```bash
npm install -g @honeyfield/clockify-mcp
```

Or use directly with npx:

```bash
npx @honeyfield/clockify-mcp
```

## Configuration

### Environment Variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `CLOCKIFY_API_KEY` | Yes | - | Your Clockify API key |
| `CLOCKIFY_REGION` | No | `global` | API region (see below) |
| `CLOCKIFY_WORKSPACE_ID` | No | - | Default workspace ID |

### Regions

| Region | Description |
|--------|-------------|
| `global` | Global (api.clockify.me) - Default |
| `euc1` | EU (euc1.clockify.me) |
| `use2` | USA (use2.clockify.me) |
| `euw2` | UK (euw2.clockify.me) |
| `apse2` | Australia (apse2.clockify.me) |

## Usage with Claude Desktop / Claude Code

Add to your Claude configuration:

```json
{
  "mcpServers": {
    "clockify": {
      "command": "npx",
      "args": ["@honeyfield/clockify-mcp"],
      "env": {
        "CLOCKIFY_API_KEY": "<your-api-key>"
      }
    }
  }
}
```

## Available Tools (37 total)

### Workspaces (3 tools)

| Tool | Description |
|------|-------------|
| `list_workspaces` | List all workspaces |
| `get_workspace` | Get workspace details |
| `get_current_workspace` | Get current/default workspace |

### Time Entries (8 tools)

| Tool | Description |
|------|-------------|
| `list_time_entries` | List time entries with filters |
| `get_time_entry` | Get single time entry |
| `create_time_entry` | Create new time entry |
| `update_time_entry` | Update time entry |
| `delete_time_entry` | Delete time entry |
| `start_timer` | Start running timer |
| `stop_timer` | Stop running timer |
| `get_running_timer` | Get currently running timer |

### Projects (6 tools)

| Tool | Description |
|------|-------------|
| `list_projects` | List projects with filters |
| `get_project` | Get project details |
| `create_project` | Create new project |
| `update_project` | Update project |
| `delete_project` | Delete (archive) project |
| `add_project_member` | Add user to project |

### Tasks (5 tools)

| Tool | Description |
|------|-------------|
| `list_tasks` | List project tasks |
| `get_task` | Get task details |
| `create_task` | Create new task |
| `update_task` | Update task |
| `delete_task` | Delete task |

### Clients (4 tools)

| Tool | Description |
|------|-------------|
| `list_clients` | List clients |
| `get_client` | Get client details |
| `create_client` | Create new client |
| `delete_client` | Delete (archive) client |

### Tags (4 tools)

| Tool | Description |
|------|-------------|
| `list_tags` | List tags |
| `get_tag` | Get tag details |
| `create_tag` | Create new tag |
| `delete_tag` | Delete tag |

### Users (3 tools)

| Tool | Description |
|------|-------------|
| `get_current_user` | Get current user |
| `list_workspace_users` | List workspace members |
| `get_user` | Get user details |

### Reports (4 tools)

| Tool | Description |
|------|-------------|
| `get_detailed_report` | Get detailed time report |
| `get_summary_report` | Get summary report |
| `get_weekly_report` | Get weekly report |
| `list_shared_reports` | List shared reports |

## Getting Your API Key

1. Log in to [Clockify](https://clockify.me)
2. Click on your profile icon (top right) → **Profile Settings**
3. Scroll down to the **API** section or go directly to: https://app.clockify.me/user/preferences#advanced
4. Click **Generate** to create a new API key
5. Copy the key and store it securely (it won't be shown again)

> **Note:** If you're using a regional server (EU, US, UK, etc.), make sure to generate the API key from that region's app (e.g., https://euc1.clockify.me for EU).

## Development

```bash
# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev

# Test with MCP Inspector
npm run inspect
```

## License

MIT