C

Clockify

clockify

Integrate with Clockify API to track time, and manage projects, clients, tasks, tags, and workspaces using OAuth authentication.

数据来源：ClawHub。在 ClawSkills 查看

645下载量

0收藏数

0浏览量

安装

选择你使用的 Agent

方法一：命令行安装（推荐）

关于 Clockify

--- name: clockify description: | Clockify API integration with managed OAuth. Track time, manage projects, clients, tasks, and workspaces. Use this skill when users want to track time, create or manage projects, view time entries, or manage workspace members. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). compatibility: Requires network access and valid Maton API key metadata: author: maton version: "1.0" clawdbot: emoji: 🧠 homepage: "https://maton.ai" requires: env: - MATON_API_KEY ---

Clockify

Access the Clockify API with managed OAuth authentication. Track time, manage projects, clients, tasks, tags, and workspaces.

Quick Start

# Get current user
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/clockify/api/v1/user')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Base URL

https://gateway.maton.ai/clockify/{native-api-path}

Replace {native-api-path} with the actual Clockify API endpoint path. The gateway proxies requests to api.clockify.me and automatically injects your credentials.

Authentication

All requests require the Maton API key in the Authorization header:

Authorization: Bearer $MATON_API_KEY

Environment Variable: Set your API key as MATON_API_KEY:

export MATON_API_KEY="YOUR_API_KEY"

Getting Your API Key

Sign in or create an account at maton.ai
Go to maton.ai/settings
Copy your API key

Connection Management

Manage your Clockify OAuth connections at https://ctrl.maton.ai.

List Connections

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=clockify&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Create Connection

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'clockify'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Get Connection

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Response:

{
  "connection": {
    "connection_id": "13fe7b78-42ba-4b43-9631-69a4bf7091ec",
    "status": "ACTIVE",
    "creation_time": "2026-02-13T09:18:02.529448Z",
    "last_updated_time": "2026-02-13T09:18:09.334540Z",
    "url": "https://connect.maton.ai/?session_token=...",
    "app": "clockify",
    "metadata": {}
  }
}

Open the returned url in a browser to complete OAuth authorization.

Delete Connection

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Specifying Connection

If you have multiple Clockify connections, specify which one to use with the Maton-Connection header:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/clockify/api/v1/user')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Maton-Connection', '13fe7b78-42ba-4b43-9631-69a4bf7091ec')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

If omitted, the gateway uses the default (oldest) active connection.

API Reference

User Operations

Get Current User

GET /clockify/api/v1/user

Response:

{
  "id": "698eeb9f5cd3a921db12069f",
  "email": "[email protected]",
  "name": "John Doe",
  "activeWorkspace": "698eeb9e5cd3a921db120693",
  "defaultWorkspace": "698eeb9e5cd3a921db120693",
  "status": "ACTIVE"
}

Workspace Operations

List Workspaces

GET /clockify/api/v1/workspaces

Get Workspace

GET /clockify/api/v1/workspaces/{workspaceId}

Create Workspace

POST /clockify/api/v1/workspaces
Content-Type: application/json

{
  "name": "My Workspace"
}

List Workspace Users

GET /clockify/api/v1/workspaces/{workspaceId}/users

Project Operations

List Projects

GET /clockify/api/v1/workspaces/{workspaceId}/projects

Get Project

GET /clockify/api/v1/workspaces/{workspaceId}/projects/{projectId}

Create Project

POST /clockify/api/v1/workspaces/{workspaceId}/projects
Content-Type: application/json

{
  "name": "My Project",
  "isPublic": true,
  "clientId": "optional-client-id"
}

Response:

{
  "id": "698f7cba4f748f6209ea8995",
  "name": "My Project",
  "clientId": "",
  "workspaceId": "698eeb9e5cd3a921db120693",
  "billable": true,
  "color": "#1976D2",
  "archived": false,
  "public": true
}

Update Project

PUT /clockify/api/v1/workspaces/{workspaceId}/projects/{projectId}
Content-Type: application/json

{
  "name": "Updated Project Name",
  "archived": true
}

Delete Project

DELETE /clockify/api/v1/workspaces/{workspaceId}/projects/{projectId}

Note: You cannot delete active projects. Set archived: true first.

Client Operations

List Clients

GET /clockify/api/v1/workspaces/{workspaceId}/clients

Get Client

GET /clockify/api/v1/workspaces/{workspaceId}/clients/{clientId}

Create Client

POST /clockify/api/v1/workspaces/{workspaceId}/clients
Content-Type: application/json

{
  "name": "Acme Corp",
  "address": "123 Main St",
  "note": "Important client"
}

Response:

{
  "id": "698f7cba0705b7d880830262",
  "name": "Acme Corp",
  "workspaceId": "698eeb9e5cd3a921db120693",
  "archived": false,
  "address": "123 Main St",
  "note": "Important client"
}

Update Client

PUT /clockify/api/v1/workspaces/{workspaceId}/clients/{clientId}
Content-Type: application/json

{
  "name": "Acme Corporation"
}

Delete Client

DELETE /clockify/api/v1/workspaces/{workspaceId}/clients/{clientId}

Tag Operations

List Tags

GET /clockify/api/v1/workspaces/{workspaceId}/tags

Get Tag

GET /clockify/api/v1/workspaces/{workspaceId}/tags/{tagId}

Create Tag

POST /clockify/api/v1/workspaces/{workspaceId}/tags
Content-Type: application/json

{
  "name": "urgent"
}

Response:

{
  "id": "698f7cbbaa9e9f33e5fc0126",
  "name": "urgent",
  "workspaceId": "698eeb9e5cd3a921db120693",
  "archived": false
}

Update Tag

PUT /clockify/api/v1/workspaces/{workspaceId}/tags/{tagId}
Content-Type: application/json

{
  "name": "high-priority"
}

Delete Tag

DELETE /clockify/api/v1/workspaces/{workspaceId}/tags/{tagId}

Task Operations

List Tasks on Project

GET /clockify/api/v1/workspaces/{workspaceId}/projects/{projectId}/tasks

Get Task

GET /clockify/api/v1/workspaces/{workspaceId}/projects/{projectId}/tasks/{taskId}

Create Task

POST /clockify/api/v1/workspaces/{workspaceId}/projects/{projectId}/tasks
Content-Type: application/json

{
  "name": "Implement feature",
  "assigneeIds": ["user-id-1"],
  "estimate": "PT2H",
  "billable": true
}

...

Prompt 示例

安装 Clockify 后，可以对 AI 说这些话来触发它

U

Help me get started with Clockify

A

Explains what Clockify does, walks through the setup, and runs a quick demo based on your current project

U

Use Clockify to integrate with Clockify API to track time, and manage projects, cli...

A

Invokes Clockify with the right parameters and returns the result directly in the conversation

U

What can I do with Clockify in my product manager workflow?

A

Lists the top use cases for Clockify, with example commands for each scenario

常见问题

如何安装 Clockify？▾

将技能文件夹放到 ~/.claude/skills/clockify/ 目录（个人级，所有项目可用），或 .claude/skills/clockify/（项目级）。重启 AI 客户端后，用 /clockify 主动调用，或让 AI 根据上下文自动发现并使用。

Clockify 支持哪些 AI 平台？▾

Clockify 支持 Claude、Cursor、OpenClaw，可与这些 AI 平台无缝集成，扩展其能力。

Clockify 是免费的吗？▾

Clockify 可免费安装使用。请查阅仓库了解许可证信息。

Clockify 有什么功能？▾

Integrate with Clockify API to track time, and manage projects, clients, tasks, tags, and workspaces using OAuth authentication.

Clockify 属于哪个分类？▾

Clockify 属于「Product Manager」分类，该分类的技能帮助 AI 智能体在此领域执行专业任务。

使用场景

Getting Started with Clockify→Automate Product Manager Workflows with Clockify→Team Collaboration with Clockify→

Clockify

安装

关于 Clockify

Clockify

Quick Start

Base URL

Authentication

Getting Your API Key

Connection Management

List Connections

Create Connection

Get Connection

Delete Connection

Specifying Connection

API Reference

User Operations

Get Current User

Workspace Operations

List Workspaces

Get Workspace

Create Workspace

List Workspace Users

Project Operations

List Projects

Get Project

Create Project

Update Project

Delete Project

Client Operations

List Clients

Get Client

Create Client

Update Client

Delete Client

Tag Operations

List Tags

Get Tag

Create Tag

Update Tag

Delete Tag

Task Operations

List Tasks on Project

Get Task

Create Task

Prompt 示例

常见问题

使用场景

同类技能推荐

Trello

Specialized Agents

Stripe

Productivity