Skip to content
MCP server

Artesa MCP by usefulapi

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

Install
Runs
Remotely
Version
1.7.0
Listing updated
4 days ago

About Artesa MCP by usefulapi

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

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "artesa": {
      "url": "https://artesa.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": {
    "artesa": {
      "type": "http",
      "url": "https://artesa.usefulapi.io/mcp"
    }
  }
}

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

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

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

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

Tools this server provides (18)

Read directly from the server.

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.

Artesa MCP by usefulapi 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