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
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.
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
安装
npx @jeremyvyska/clockify-mcp配置
{
"mcpServers": {
"clockify": {
"command": "node",
"args": ["C:\\Work\\community\\ClockifyTools\\clockify-mcp\\build\\index.js"],
"env": {
"CLOCKIFY_API_KEY": "your-api-key-here"
}
}
}
}