# Artesa MCP by usefulapi

> Artesa MCP by usefulapi is an MCP server. Read customers, assignments, staff, time entries and absences; create customers in Artesa. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read customers, assignments, staff, time entries and absences; create customers in Artesa.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `artesa_list_customers`: List customers (private persons or companies that assignments are carried out for). Filter by company name, number or external id. Artesa API: GET /v2/customers.
- `artesa_get_customer`: Get one customer with its phones, emails, URLs and billing address. Artesa API: GET /v2/customers/{customerUuid}.
- `artesa_create_customer`: Create a new customer record (company or private person). Not safe to retry: a retry creates a second customer. Artesa API: POST /v2/customers.
- `artesa_list_assignments`: List assignments (orders/jobs) with their customer, project, type, responsible user and status. Artesa API: GET /v2/assignments.
- `artesa_get_assignment`: Get one assignment with its details. Artesa API: GET /v2/assignments/{assignmentUuid}.
- `artesa_list_assignment_events`: List work steps (appointments and events) of assignments, optionally in a time window. Artesa API: GET /v2/assignment-events.
- `artesa_get_assignment_event`: Get one assignment event (work step). Artesa API: GET /v2/assignment-events/{assignmentEventUuid}.
- `artesa_list_projects`: List projects that group assignments. Artesa API: GET /v2/projects.
- `artesa_get_project`: Get one project. Artesa API: GET /v2/projects/{projectUuid}.
- `artesa_list_users`: List users (staff members) with their role. Filter by name, email or role. Artesa API: GET /v2/users.
- `artesa_get_user`: Get one user (staff member). Artesa API: GET /v2/users/{userUuid}.
- `artesa_list_time_entries`: List recorded time entries (work time) per user, assignment or event, optionally in a time window. Artesa API: GET /v2/time-entries.
- `artesa_list_user_absences`: List absences (holidays, sick days and similar) of users in a time window. Artesa API: GET /v2/user-absences.
- `artesa_list_time_sheet_weeks`: List weekly time sheets per user, with their status. Artesa API: GET /v2/time-sheet-weeks.
- `artesa_list_assignment_status_types`: List the assignment status types (Auftragsstatus) your company uses. Artesa API: GET /v2/assignment-status-types.
- `artesa_list_assignment_types`: List the assignment types (Auftragstypen) your company uses. Artesa API: GET /v2/assignment-types.
- `artesa_list_gangs`: List gangs (work crews or teams) of your company. Artesa API: GET /v2/gangs.
- `artesa_list_roles`: List the user roles (Benutzerrollen) of your company. Artesa API: GET /v2/roles.

## FAQ

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

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

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