MCP Clockify Server

MCP server for Clockify time tracking integration with Claude.

Features

• Start/Stop Timer - Track time on tasks identified by prefix (e.g., ABC-123)
• Auto-create Tasks - Create new tasks when they don't exist
• Time Multiplication - Duplicate time entries for billing adjustments
• Self-configuration - Guided setup wizard for workspace and project selection

Installation

1. Get your Clockify API key

Get your API key here

2. Create or update .env file in your project

CLOCKIFY_API_KEY=your_api_key_here

3. Add to your project .mcp.json

{
  "mcpServers": {
    "clockify": {
      "command": "bash",
      "args": [
        "-c",
        "export $(cat .claude/.env.local | xargs) && npx -y @d4works/mcp-clockify@latest"
      ]
    }
  }
}

The source .env command loads your CLOCKIFY_API_KEY from the .env file before starting the server.

4. Restart Claude Code and configure

After restart, tell Claude to configure CLockify

The configuration wizard will guide you through selecting your workspace, project, task prefix, and language.

Available Tools

| Tool | Description | | ------------------- | --------------------------------- | | test-connection | Test Clockify API connection | | get-running-timer | Check if a timer is running | | start-timer | Start timer for a task | | stop-timer | Stop running timer | | multiply-time | Duplicate last time entry | | create-task | Create new task in Clockify | | reconfigure | Change workspace/project settings |

Usage Examples

Start tracking:

Start timer for task 123 with description "Implementing login form"

Stop timer:

Stop the timer

Check status:

What timer is currently running?

License

MIT