# Cezanne HR MCP by usefulapi

> Cezanne HR MCP by usefulapi is a freemium MCP server for hr and payroll. Read-only MCP connector for Cezanne HR people, absence and timesheet data in AI clients. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web
- **Website:** https://usefulapi.io/cezanne-hr/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/cezanne-hr
- **MCP Registry name:** io.usefulapi/cezanne-hr
- **Categories:** hr and payroll
- **Listing updated:** 2026-11-18

## About

The server is hosted by usefulapi and connects an AI client to a Cezanne HR account over OAuth, so you log in with a Cezanne HR Authorised Application rather than placing a key in a config file. Once connected, the assistant can look up people and their current primary employment, list org units, and pull absence events and timesheets, with a generic table reader for other permitted Cezanne HR tables.

All seven data tools are marked read-only, and the README states the server makes no writes. Four meta tools handle usage reporting, feature requests, and Pro or Pro+ subscription changes. The README notes that the AI's LLM provider receives the HR data that the assistant reads.

The listing is aimed at HR teams and managers who want to ask plain-language questions about joiners, leavers, absences or unapproved timesheets in Cezanne HR. usefulapi says it is an independent service and is not affiliated with Cezanne HR.

## Features

- **Read-only Cezanne HR access:** The seven data tools only read from Cezanne HR and do not modify records.
- **People and employment lookup:** Lists people, including leavers and new hires, and reads a person's current primary employment by Person Code.
- **Absence and timesheet queries:** Lists absence events and person timesheets, filterable by date or person using OData filters.
- **Org unit listing:** Returns departments, teams and locations as configured in Cezanne HR.
- **OAuth sign-in:** Users log in with a Client ID and Client secret from a Cezanne HR Authorised Application, with no API key in client config.
- **Broad client support:** Works with Claude, ChatGPT, Claude Code, Cursor, VS Code, Codex and other Streamable HTTP MCP clients.

## Good for

- Find employees who joined or left in the last 30 days and their org unit
- Count absence events for a team over a quarter
- Check which timesheet entries are still unapproved
- Look up a person's current primary employment record

## Install

### Claude Code (Terminal)

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

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

```sh
https://cezanne-hr.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "cezanne-hr": {
      "url": "https://cezanne-hr.usefulapi.io/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "cezanne-hr": {
      "serverUrl": "https://cezanne-hr.usefulapi.io/mcp"
    }
  }
}
```

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

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

## Tools

- `cezannehr_list_people`: List people in Cezanne HR, including leavers and new hires unless active_only is true.
- `cezannehr_get_person`: Get one person by Person Code, optionally with selected fields.
- `cezannehr_get_current_employment`: Get the current primary employment of one person by Person Code.
- `cezannehr_list_org_units`: List organisational units such as departments, teams and locations.
- `cezannehr_list_absence_events`: List absence events (leave and sickness) for people, filterable by date or person.
- `cezannehr_list_timesheets`: List person timesheets for a period.
- `cezannehr_read_table`: Read one page of an allowed Cezanne HR OData table. Read-only.

## FAQ

### Can the AI change my Cezanne HR data?

No. The server's seven Cezanne HR tools are marked read-only, according to the listing.

### Is this an official Cezanne HR product?

No. usefulapi is an independent service and is not affiliated with or endorsed by Cezanne HR.

### What does it cost?

A Free plan gives 50 tool calls per month. Pro is $9/month or $90/year with 10,000 calls per month. Pro+ is $39/month or $390/year with 100,000 calls per month.

### What do I need to connect?

The login page asks for the Client ID and Client secret of a Cezanne HR Authorised Application with Read permission.

### Is Cezanne HR MCP by usefulapi free?

Cezanne HR MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

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

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

### What are the best alternatives to Cezanne HR MCP by usefulapi?

The closest alternatives to Cezanne HR MCP by usefulapi are When I Work MCP by usefulapi, Jisr MCP by usefulapi, intelliHR MCP by usefulapi, Employment Hero Payroll MCP by usefulapi and PaySpace MCP by usefulapi.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [When I Work MCP by usefulapi](https://ai-powered.com/mcp/when-i-work-mcp-by-usefulapi): When I Work MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Jisr MCP by usefulapi](https://ai-powered.com/mcp/jisr-mcp-by-usefulapi): Jisr MCP by usefulapi is a freemium MCP server for hr and payroll.
- [intelliHR MCP by usefulapi](https://ai-powered.com/mcp/intellihr-mcp-by-usefulapi): intelliHR MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Employment Hero Payroll MCP by usefulapi](https://ai-powered.com/mcp/employment-hero-payroll-mcp-by-usefulapi): Employment Hero Payroll MCP by usefulapi is a freemium MCP server for hr and payroll.
- [PaySpace MCP by usefulapi](https://ai-powered.com/mcp/payspace-mcp-by-usefulapi): PaySpace MCP by usefulapi is a freemium MCP server for hr and payroll.
- [TempClock MCP by usefulapi](https://ai-powered.com/mcp/tempclock-mcp-by-usefulapi): TempClock MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Breathe HR MCP by usefulapi](https://ai-powered.com/mcp/breathe-hr-mcp-by-usefulapi): Breathe HR MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Go2Clock MCP by usefulapi](https://ai-powered.com/mcp/go2clock-mcp-by-usefulapi): Go2Clock MCP by usefulapi is a freemium MCP server for hr and payroll.

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