# clockin MCP by usefulapi

> clockin MCP by usefulapi is an MCP server. Read employees, absences, projects and work days; create absences and time events in clockin. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/clockin/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/clockin
- **MCP Registry name:** io.usefulapi/clockin
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://clockin.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "clockin": {
      "url": "https://clockin.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/clockin-mcp-by-usefulapi
