# Bedrijfsrooster MCP by usefulapi

> Bedrijfsrooster MCP by usefulapi is an MCP server. Read employees, contracts, timetable shifts, availability and reports in Bedrijfsrooster. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Read employees, contracts, timetable shifts, availability and reports in Bedrijfsrooster.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `bedrijfsrooster_get_configuration`: Get the company this access token belongs to: its id and name, its group, and its locations, departments, functions and shift types. Call this first. The ids it returns are the filters for the other tools. Bedrijfsrooster API: GET /configuration.
- `bedrijfsrooster_list_users`: List the employees (CompanyUsers) with an active or future employment in the company, optionally within a period. Set extendedDetails only when the user asks for personal details: it adds birthday, email and address. Bedrijfsrooster API: GET /users.
- `bedrijfsrooster_list_contracts`: List the contracts between the company and its employees that are active at the snapshot date or within a period. Bedrijfsrooster API: GET /contracts.
- `bedrijfsrooster_list_timetable`: List the shifts of the company timetable: scheduled work shifts, availability, relief (vacation, days off) and non-attendance (sick days, no-shows). Choose which kinds to include with the shifts* flags. The reply is paged: use pageIndex (from 1) and itemsPerPage (1 to 1000), or disablePaging for a single reply. Bedrijfsrooster API: GET /timetable.
- `bedrijfsrooster_get_report`: Get the stored result of one finished Bedrijfsrooster report by its reportId, for example the relief hours balance. A report that is still running returns HTTP 409 with its percentage_complete: call again later. Needs the company:reports:read integration permission. Bedrijfsrooster API: GET /reports.
- `bedrijfsrooster_get_availability`: Get the availability (beschikbaarheid) per date, for each employee (companyUser) or each function (companyFunction). Use periodStart and periodEnd together, within one month (up to 31 days). Needs the company:availability:read integration permission. Bedrijfsrooster API: GET /availability.

## FAQ

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

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

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