@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

$3

| 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 |

$3

| 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": ""
}
}
}
}
`

Available Tools (37 total)

$3

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

$3

| 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 |

$3

| 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 |

$3

| 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 |

$3

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

$3

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

$3

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

$3

| 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
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