Skip to content
MCP server

clockin MCP by usefulapi

Read employees, absences, projects and work days; create absences and time events in…

Install
Runs
Remotely
Version
1.3.0
Listing updated
4 days ago

About clockin MCP by usefulapi

clockin MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read employees, absences, projects and work days; create absences and time events in clockin.

Install

Run in a terminal

claude mcp add --transport http clockin https://clockin.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://clockin.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "clockin": {
      "url": "https://clockin.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "clockin": {
      "type": "http",
      "url": "https://clockin.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "clockin": {
      "serverUrl": "https://clockin.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "clockin": {
      "type": "http",
      "url": "https://clockin.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (13)

Read directly from the server.

clockin_list_employees
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.
clockin_get_employee
Get one employee by id. Customer API: GET /v3/employees/{employee}.
clockin_search_employees
Find employees whose last name matches exactly. Customer API: POST /v3/employees/search with scope byLastName.
clockin_list_customers
List customers of the company, paged. Customer API: GET /v3/customers.
clockin_get_customer
Get one customer by id. Customer API: GET /v3/customers/{customer}.
clockin_list_absences
List absences (vacation, sick days, workshops and similar), paged. Customer API: GET /v3/absences.
clockin_search_absences
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.
clockin_get_absence
Get one absence by id. Customer API: GET /v3/absences/{absence}.
clockin_list_projects
List projects, paged. Use include=employees,subProjects for the assigned staff and sub-projects. Customer API: GET /v3/projects.
clockin_get_project
Get one project by id. Customer API: GET /v3/projects/{project}.
clockin_search_workdays
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.
clockin_create_absence
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.
clockin_create_event
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.

clockin MCP by usefulapi FAQ

How do I add clockin MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http clockin https://clockin.usefulapi.io/mcp