clockin MCP by usefulapi is an MCP server published by io.usefulapi, hosted at clockin.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 13 tools, including clockin_list_employees, clockin_get_employee, clockin_search_employees, clockin_list_customers, clockin_get_customer.
Read employees, absences, projects and work days; create absences and time events in clockin.
4,042 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| limit | integer | Rows per page (default 50, max 150). |
| include | string | One relation to include: department, files, superior, onboardingSecret or customFields. |
{
"name": "clockin_list_employees",
"title": "List employees",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 150,
"description": "Rows per page (default 50, max 150).",
"exclusiveMinimum": 0
},
"include": {
"type": "string",
"description": "One relation to include: department, files, superior, onboardingSecret or customFields."
}
}
},
"annotations": {
"title": "List employees",
"readOnlyHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Get one employee by id. Customer API: GET /v3/employees/{employee}.
| Parameter | Type | Description |
|---|---|---|
| include | string | One relation to include: department, files, superior, onboardingSecret or customFields. |
| employee_id * | integer | Employee id (from clockin_list_employees). |
{
"name": "clockin_get_employee",
"title": "Get an employee",
"description": "Get one employee by id. Customer API: GET /v3/employees/{employee}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"employee_id"
],
"properties": {
"include": {
"type": "string",
"description": "One relation to include: department, files, superior, onboardingSecret or customFields."
},
"employee_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Employee id (from clockin_list_employees).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get an employee",
"readOnlyHint": true
}
}Find employees whose last name matches exactly. Customer API: POST /v3/employees/search with scope byLastName.
| Parameter | Type | Description |
|---|---|---|
| last_name * | string | Last name to match exactly. |
{
"name": "clockin_search_employees",
"title": "Search employees by last name",
"description": "Find employees whose last name matches exactly. Customer API: POST /v3/employees/search with scope byLastName.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"last_name"
],
"properties": {
"last_name": {
"type": "string",
"minLength": 1,
"description": "Last name to match exactly."
}
}
},
"annotations": {
"title": "Search employees by last name",
"readOnlyHint": true
}
}List customers of the company, paged. Customer API: GET /v3/customers.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| limit | integer | Rows per page (default 50, max 150). |
{
"name": "clockin_list_customers",
"title": "List customers",
"description": "List customers of the company, paged. Customer API: GET /v3/customers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 150,
"description": "Rows per page (default 50, max 150).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List customers",
"readOnlyHint": true
}
}Get one customer by id. Customer API: GET /v3/customers/{customer}.
| Parameter | Type | Description |
|---|---|---|
| customer_id * | integer | Customer id (from clockin_list_customers). |
{
"name": "clockin_get_customer",
"title": "Get a customer",
"description": "Get one customer by id. Customer API: GET /v3/customers/{customer}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_id"
],
"properties": {
"customer_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Customer id (from clockin_list_customers).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a customer",
"readOnlyHint": true
}
}List absences (vacation, sick days, workshops and similar), paged. Customer API: GET /v3/absences.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| limit | integer | Rows per page (default 50, max 150). |
{
"name": "clockin_list_absences",
"title": "List absences",
"description": "List absences (vacation, sick days, workshops and similar), paged. Customer API: GET /v3/absences.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 150,
"description": "Rows per page (default 50, max 150).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List absences",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| approvals | array | Approval states to include. |
| starts_from | string | Only absences that start at or after this ISO 8601 date-time. |
{
"name": "clockin_search_absences",
"title": "Search absences",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"approvals": {
"type": "array",
"items": {
"enum": [
"denied",
"granted",
"pending"
],
"type": "string"
},
"minItems": 1,
"description": "Approval states to include."
},
"starts_from": {
"type": "string",
"minLength": 1,
"description": "Only absences that start at or after this ISO 8601 date-time."
}
}
},
"annotations": {
"title": "Search absences",
"readOnlyHint": true
}
}Get one absence by id. Customer API: GET /v3/absences/{absence}.
| Parameter | Type | Description |
|---|---|---|
| absence_id * | integer | Absence id (from clockin_list_absences). |
{
"name": "clockin_get_absence",
"title": "Get an absence",
"description": "Get one absence by id. Customer API: GET /v3/absences/{absence}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"absence_id"
],
"properties": {
"absence_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Absence id (from clockin_list_absences).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get an absence",
"readOnlyHint": true
}
}List projects, paged. Use include=employees,subProjects for the assigned staff and sub-projects. Customer API: GET /v3/projects.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| limit | integer | Rows per page (default 50, max 150). |
| include | string | Comma-separated relations to include, for example employees,subProjects or signedUrl. |
{
"name": "clockin_list_projects",
"title": "List projects",
"description": "List projects, paged. Use include=employees,subProjects for the assigned staff and sub-projects. Customer API: GET /v3/projects.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number (default 1).",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 150,
"description": "Rows per page (default 50, max 150).",
"exclusiveMinimum": 0
},
"include": {
"type": "string",
"description": "Comma-separated relations to include, for example employees,subProjects or signedUrl."
}
}
},
"annotations": {
"title": "List projects",
"readOnlyHint": true
}
}Get one project by id. Customer API: GET /v3/projects/{project}.
| Parameter | Type | Description |
|---|---|---|
| include | string | Comma-separated relations to include, for example employees,subProjects or signedUrl. |
| project_id * | integer | Project id (from clockin_list_projects). |
{
"name": "clockin_get_project",
"title": "Get a project",
"description": "Get one project by id. Customer API: GET /v3/projects/{project}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id"
],
"properties": {
"include": {
"type": "string",
"description": "Comma-separated relations to include, for example employees,subProjects or signedUrl."
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Project id (from clockin_list_projects).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a project",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| end_date * | string | Last day, yyyy-mm-dd. |
| start_date * | string | First day, yyyy-mm-dd. |
| employee_ids * | array | Employee ids to include. |
{
"name": "clockin_search_workdays",
"title": "Search workdays",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"employee_ids",
"start_date",
"end_date"
],
"properties": {
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, yyyy-mm-dd."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, yyyy-mm-dd."
},
"employee_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"minItems": 1,
"description": "Employee ids to include."
}
}
},
"annotations": {
"title": "Search workdays",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| ends_at * | string | ISO 8601 date-time, for example 2026-11-02T08:00:00+01:00. |
| approval * | string | one of ["denied","granted","pending"] |
| duration | string | How the duration is set. |
| starts_at * | string | ISO 8601 date-time, for example 2026-11-02T08:00:00+01:00. |
| employee_id * | integer | Employee id. |
| absencecategory_name * | string | Absence category name set up in clockin. |
{
"name": "clockin_create_absence",
"title": "Create an absence",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"employee_id",
"absencecategory_name",
"starts_at",
"ends_at",
"approval"
],
"properties": {
"ends_at": {
"type": "string",
"minLength": 1,
"description": "ISO 8601 date-time, for example 2026-11-02T08:00:00+01:00."
},
"approval": {
"enum": [
"denied",
"granted",
"pending"
],
"type": "string"
},
"duration": {
"enum": [
"full_day",
"half_day",
"start_end"
],
"type": "string",
"description": "How the duration is set."
},
"starts_at": {
"type": "string",
"minLength": 1,
"description": "ISO 8601 date-time, for example 2026-11-02T08:00:00+01:00."
},
"employee_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Employee id.",
"exclusiveMinimum": 0
},
"absencecategory_name": {
"type": "string",
"minLength": 1,
"description": "Absence category name set up in clockin."
}
}
},
"annotations": {
"title": "Create an absence",
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| task_id * | integer | Task id, 2 to 10 (see description). |
| occured_at * | string | When the event happened, ISO 8601. |
| project_id | integer | Project id, for project time. |
| task_label | string | Custom task label. Only configured label and task id pairs are valid. |
| employee_id * | integer | Employee id. |
{
"name": "clockin_create_event",
"title": "Create a time event",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"employee_id",
"occured_at",
"task_id"
],
"properties": {
"task_id": {
"type": "integer",
"maximum": 10,
"minimum": 2,
"description": "Task id, 2 to 10 (see description)."
},
"occured_at": {
"type": "string",
"minLength": 1,
"description": "When the event happened, ISO 8601."
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Project id, for project time.",
"exclusiveMinimum": 0
},
"task_label": {
"type": "string",
"description": "Custom task label. Only configured label and task id pairs are valid."
},
"employee_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Employee id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Create a time event",
"destructiveHint": true
}
}Tools for clockin, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which employees are on absence next week?"; "How many hours did each employee book on project 14 last month?"; "Create a vacation absence for employee 12 from 2 to 6 December, granted.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes clockin data. Free plan: 50 tool calls per month. Run clockin_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run clockin_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run clockin_upgrade without a plan: it returns both plans, each with a payment link for the user to open. clockin_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.