clockin MCP by usefulapi
Read employees, absences, projects and work days; create absences and time events in clockin.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"clockin": {
"url": "https://clockin.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://clockin.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (13)
🟢clockin_list_employees(limit, page, include)
List employees of the company, paged. Returns id, names, email and related data. Use the ids with the other tools. Customer API: GET /v3/employees.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"description": "Rows per page (default 50, max 150).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 150
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"include": {
"description": "One relation to include: department, files, superior, onboardingSecret or customFields.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clockin_get_employee(employee_id, include)
Get one employee by id. Customer API: GET /v3/employees/{employee}.
입력 스키마
{
"type": "object",
"properties": {
"employee_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Employee id (from clockin_list_employees)."
},
"include": {
"description": "One relation to include: department, files, superior, onboardingSecret or customFields.",
"type": "string"
}
},
"required": [
"employee_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clockin_search_employees(last_name)
Find employees whose last name matches exactly. Customer API: POST /v3/employees/search with scope byLastName.
입력 스키마
{
"type": "object",
"properties": {
"last_name": {
"type": "string",
"minLength": 1,
"description": "Last name to match exactly."
}
},
"required": [
"last_name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clockin_list_customers(limit, page)
List customers of the company, paged. Customer API: GET /v3/customers.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"description": "Rows per page (default 50, max 150).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 150
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clockin_get_customer(customer_id)
Get one customer by id. Customer API: GET /v3/customers/{customer}.
입력 스키마
{
"type": "object",
"properties": {
"customer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Customer id (from clockin_list_customers)."
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clockin_list_absences(limit, page)
List absences (vacation, sick days, workshops and similar), paged. Customer API: GET /v3/absences.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"description": "Rows per page (default 50, max 150).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 150
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clockin_search_absences(starts_from, approvals)
Find absences by start time (from this date-time on) and/or approval state. Pass at least one filter. Customer API: POST /v3/absences/search with scopes byStartsAt and byApprovals.
입력 스키마
{
"type": "object",
"properties": {
"starts_from": {
"description": "Only absences that start at or after this ISO 8601 date-time.",
"type": "string",
"minLength": 1
},
"approvals": {
"description": "Approval states to include.",
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"enum": [
"denied",
"granted",
"pending"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clockin_get_absence(absence_id)
Get one absence by id. Customer API: GET /v3/absences/{absence}.
입력 스키마
{
"type": "object",
"properties": {
"absence_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Absence id (from clockin_list_absences)."
}
},
"required": [
"absence_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clockin_list_projects(limit, page, include)
List projects, paged. Use include=employees,subProjects for the assigned staff and sub-projects. Customer API: GET /v3/projects.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"description": "Rows per page (default 50, max 150).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 150
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"include": {
"description": "Comma-separated relations to include, for example employees,subProjects or signedUrl.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clockin_get_project(project_id, include)
Get one project by id. Customer API: GET /v3/projects/{project}.
입력 스키마
{
"type": "object",
"properties": {
"project_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Project id (from clockin_list_projects)."
},
"include": {
"description": "Comma-separated relations to include, for example employees,subProjects or signedUrl.",
"type": "string"
}
},
"required": [
"project_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clockin_search_workdays(employee_ids, start_date, end_date)
Get the work days of employees for a date range. Each day lists its activities (start, end, project_id) and events. Sum activities by project_id for project hours. Customer API: POST /v3/workdays/search.
입력 스키마
{
"type": "object",
"properties": {
"employee_ids": {
"minItems": 1,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": "Employee ids to include."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, yyyy-mm-dd."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, yyyy-mm-dd."
}
},
"required": [
"employee_ids",
"start_date",
"end_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴clockin_create_absence(employee_id, absencecategory_name, starts_at, ends_at, approval, ...)
WRITE: create an absence for one employee. absencecategory_name must match an absence category set up in clockin (for example workshop). approval is denied, granted or pending. Customer API: POST /v3/absences.
입력 스키마
{
"type": "object",
"properties": {
"employee_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Employee id."
},
"absencecategory_name": {
"type": "string",
"minLength": 1,
"description": "Absence category name set up in clockin."
},
"starts_at": {
"type": "string",
"minLength": 1,
"description": "ISO 8601 date-time, for example 2026-11-02T08:00:00+01:00."
},
"ends_at": {
"type": "string",
"minLength": 1,
"description": "ISO 8601 date-time, for example 2026-11-02T08:00:00+01:00."
},
"approval": {
"type": "string",
"enum": [
"denied",
"granted",
"pending"
]
},
"duration": {
"description": "How the duration is set.",
"type": "string",
"enum": [
"full_day",
"half_day",
"start_end"
]
}
},
"required": [
"employee_id",
"absencecategory_name",
"starts_at",
"ends_at",
"approval"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴clockin_create_event(employee_id, occured_at, task_id, task_label, project_id)
WRITE: record a clock event for one employee, for example a back-dated start of work. task_id: 2 LOADING_TIME, 3 DRIVING_TIME, 4 PROJECT, 5 PAUSE, 6 SPECIAL_1, 7 SPECIAL_2, 8 LOGOUT, 9 BUSINESS_TRIP, 10 WORKING_TIME. Customer API: POST /v3/events.
입력 스키마
{
"type": "object",
"properties": {
"employee_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Employee id."
},
"occured_at": {
"type": "string",
"minLength": 1,
"description": "When the event happened, ISO 8601."
},
"task_id": {
"type": "integer",
"minimum": 2,
"maximum": 10,
"description": "Task id, 2 to 10 (see description)."
},
"task_label": {
"description": "Custom task label. Only configured label and task id pairs are valid.",
"type": "string"
},
"project_id": {
"description": "Project id, for project time.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"employee_id",
"occured_at",
"task_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거