# Craftboxx MCP by usefulapi

> Craftboxx MCP by usefulapi is an MCP server. Read employees, assignments, timesheets and absences; create customers and projects in Craftboxx. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read employees, assignments, timesheets and absences; create customers and projects in Craftboxx.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `craftboxx_get_company`: Get the company of the signed-in account (name, address, contact data). Craftboxx API: GET /my/company.
- `craftboxx_list_employees`: List employees (name, email, phone, group, skills, inactive flag). Craftboxx API: GET /employees.
- `craftboxx_get_employee`: Get one employee by id. Craftboxx API: GET /employees/{id}.
- `craftboxx_list_customers`: List customers (name, customer number, info). Craftboxx API: GET /customers.
- `craftboxx_get_customer`: Get one customer by id. Craftboxx API: GET /customers/{id}.
- `craftboxx_list_projects`: List projects (title, project number, customer, sales volume). Craftboxx API: GET /projects.
- `craftboxx_get_project`: Get one project by id. Craftboxx API: GET /projects/{id}.
- `craftboxx_list_assignments`: List assignments (planned jobs/appointments: title, project, start, end, state, planned time). Filter by date range or employee. Craftboxx API: GET /assignments.
- `craftboxx_get_assignment`: Get one assignment by id. Craftboxx API: GET /assignments/{id}.
- `craftboxx_list_timesheets`: List timesheets (employee, start, end, working time, break time). Craftboxx API: GET /timesheets.
- `craftboxx_list_absences`: List absences such as holiday or sick leave (employee, type, start, end). Craftboxx API: GET /absences.
- `craftboxx_list_absence_types`: List absence reasons (holiday, sick, ...). Craftboxx API: GET /absences/types.
- `craftboxx_list_articles`: List articles in the material catalog (name, manufacturer, unit price, VAT rate). Craftboxx API: GET /articles.
- `craftboxx_list_documentations`: List job documentations (reports written on assignments: title, state, type, author). Craftboxx API: GET /documentations.
- `craftboxx_create_customer`: WRITE: create a new customer. Each call creates a new record (not idempotent). Craftboxx API: POST /customers.
- `craftboxx_create_project`: WRITE: create a new project for an existing customer. Each call creates a new record (not idempotent). Craftboxx API: POST /projects.

## FAQ

### How do I add Craftboxx MCP by usefulapi to Claude Code?

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

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