jeremyvyska/clockify-mcp

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

6 stars 7 forks 품질 68 트렌드 14GPL-3.0

A comprehensive MCP (Model Context Protocol) server for Clockify API integration, providing full CRUD operations across all major Clockify features.

개요

A comprehensive MCP (Model Context Protocol) server for Clockify API integration, providing full CRUD operations across all major Clockify features. This server enables LLMs like Claude to manage your entire Clockify workspace - from workspaces and clients to projects, tasks, tags, and time tracking. - - List all accessible workspaces - - Get workspace details - - Update workspace settings - - List clients with filtering (archived, name search) - - Create new client - - Update client details, archive/unarchive - - Delete client - - List projects with filtering (archived, name, client) - - Get single project details - - Create new project with client, color, billable settings - - Update project details, budget, time estimate - - Delete/archive project - - List tasks for a project - - Create task with name, estimate, assignments - - Update task status, estimate, assignments - - Delete task - - List tags in workspace - - Create new tag - - Update tag name, archive/unarchive - -...

README

원문 README의 일부입니다. 원문 보기.

Clockify MCP Server - Feature-Rich Edition

Features

Workspace Management

listWorkspaces - List all accessible workspaces
getWorkspace - Get workspace details
updateWorkspace - Update workspace settings

Client Management

listClients - List clients with filtering (archived, name search)
createClient - Create new client
updateClient - Update client details, archive/unarchive
deleteClient - Delete client

Project Management

listProjects - List projects with filtering (archived, name, client)
getProject - Get single project details
createProject - Create new project with client, color, billable settings
updateProject - Update project details, budget, time estimate
deleteProject - Delete/archive project

Task Management

listTasks - List tasks for a project
createTask - Create task with name, estimate, assignments
updateTask - Update task status, estimate, assignments
deleteTask - Delete task

Tag Management

listTags - List tags in workspace
createTag - Create new tag
updateTag - Update tag name, archive/unarchive
deleteTag - Delete tag

Time Entry Management

listTimeEntries - List time entries with filtering (date range, project, task, tags)
getTimeEntry - Get specific time entry details
createTimeEntry - Create completed time entry
updateTimeEntry - Update existing time entry
deleteTimeEntry - Delete time entry
bulkUpdateTimeEntries - Update multiple time entries at once
bulkDeleteTimeEntries - Delete multiple time entries at once

Timer Operations

startTimer - Start a new running timer
stopTimer - Stop the currently running timer
getActiveTimer - Get current running timer (if any)

Total: 33 tools covering all major Clockify operations

Quick Start

Prerequisites

Node.js 20+ installed
Clockify API key (how to obtain)

Installation

Clone this repository:

git clone https://github.com/yourusername/clockify-mcp.git
cd clockify-mcp

Install dependencies:

npm install

Build the project:

npm run build

Configuration

For Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

GitHub에서 전체 README 보기

설치

npx @jeremyvyska/clockify-mcp

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "clockify": {
      "command": "node",
      "args": ["C:\\Work\\community\\ClockifyTools\\clockify-mcp\\build\\index.js"],
      "env": {
        "CLOCKIFY_API_KEY": "your-api-key-here"
      }
    }
  }
}