# Workyard MCP by usefulapi

> Workyard MCP by usefulapi is an MCP server. Read Workyard employees, projects, time cards and geofences; approve time cards and add notes. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read Workyard employees, projects, time cards and geofences; approve time cards and add notes.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `workyard_get_organization`: The organization this connection uses (id, name, settings such as timezone) from GET /orgs/{org_id}.
- `workyard_list_employees`: List employees of the organization (employee_id, profile_id, name, title, role, status, contact data). Filter by status (active, removed, saas_disabled, expired; comma list), email, role name or free-text search. Paged: use next_page.
- `workyard_list_projects`: List projects (id, name, identifier, customer, locations). Optionally filter by name or archived state. Paged: use next_page.
- `workyard_get_project`: One project by id (workyard_list_projects gives the ids).
- `workyard_list_time_cards`: List time cards (id, employee_id, start_dt_unix, end_dt_unix, status, approver, totals). Workyard returns only status=working when no status is given, so pass status (for example submitted,approved) for finished work. Filter by employee and by start time (unix seconds, interpreted in the organization timezone). Paged: use next_page; the reply also carries time_summary.
- `workyard_get_time_card`: One time card by id, with its details (workyard_list_time_cards gives the ids).
- `workyard_list_time_card_activity_segments`: The activity segments of one time card (where and on which project the employee worked, segment by segment). Not paged.
- `workyard_list_geofences`: List geofences / work sites (id, name, place, enabled, radius). Filter by name, enabled state or project. Paged: use next_page.
- `workyard_list_active_geofences`: All active geofences with limited data (Workyard: GET active_geofences). It does not say who is clocked in; use workyard_list_time_cards with status working for that.
- `workyard_list_geofence_projects`: The projects attached to one geofence (work site). Paged: use next_page.
- `workyard_approve_time_card`: WRITE: approve ONE time card (PATCH .../time_cards/{id}/approve). Approval feeds payroll in Workyard and may not be undoable through the API: only call it when the user asked to approve this exact time card.
- `workyard_add_time_card_note`: WRITE: add a text note to one time card (POST .../time_cards/{id}/notes). Adds a new note on every call; it does not edit or delete existing notes.

## FAQ

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

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

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