# Woffu MCP by usefulapi

> Woffu MCP by usefulapi is a freemium MCP server for hr and payroll. Read-only MCP connector for Woffu users, contracts, departments and offices. 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, vscode, CLI
- **Website:** https://usefulapi.io/woffu/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/woffu
- **MCP Registry name:** io.usefulapi/woffu
- **Categories:** hr and payroll
- **Listing updated:** 2026-11-18

## About

The server lets an AI client query a company's Woffu HR data through the Woffu API, using credentials that the connecting user supplies at login. Its five data tools cover users, a single user's record, employment contracts per user, departments and offices, and all of them are read-only, so the assistant cannot change anything in Woffu.

The endpoint is hosted by usefulapi rather than installed locally. You add the URL to Claude, ChatGPT, Cursor, VS Code, Claude Code or Codex, then sign in once with your Woffu company number and an API key that a Woffu administrator generates under the profile's technical data section. The README notes that keys expire after about 90 days.

It suits HR and people teams who want to look up staff records or contract start dates conversationally. Usage is metered per tool call, with a free tier of 50 calls a month and paid plans above that.

## Features

- **Read-only Woffu data access:** Five tools list users, fetch one user, list contracts, departments and offices, with no write operations.
- **Hosted remote endpoint:** Connects over Streamable HTTP with OAuth sign-in, so no local installation is needed.
- **Per-user credentials:** Each user signs in with their own CompanyId and API key, which the server stores encrypted.
- **Usage metering tools:** Includes tools to check current usage, request a missing feature and manage the subscription.
- **Multiple AI clients:** Setup steps are documented for Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex and other MCP clients.

## Good for

- Listing the active users of a Woffu company
- Checking the employment contracts and start dates of a given employee
- Reviewing which departments and offices a Woffu company has
- Answering HR questions in a chat assistant without opening the Woffu admin screens

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `woffu_list_users`: List the users of the Woffu company.
- `woffu_get_user`: Get one user by UserId: name, company, department and status fields.
- `woffu_list_user_contracts`: List the employment contracts of one user by UserId.
- `woffu_list_departments`: List the departments of the Woffu company.
- `woffu_list_offices`: List the offices (work centres) of the Woffu company.

## FAQ

### Is this an official Woffu product?

No. The site states that usefulapi is an independent service, not affiliated with or endorsed by Woffu.

### Can the AI change my Woffu data?

No. The site says all five Woffu tools are marked read-only.

### Do I put an API key in the client config?

No. The README and site say to add only the URL; the server signs you in through OAuth and the login page asks for the CompanyId and API key.

### What does it cost?

The site lists a Free plan with 50 tool calls a month, Pro at $9/mo or $90/yr with 10,000 calls, and Pro+ at $39/mo or $390/yr with 100,000 calls.

### Is Woffu MCP by usefulapi free?

Woffu 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 Woffu MCP by usefulapi to Claude Code?

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

### What are the best alternatives to Woffu MCP by usefulapi?

The closest alternatives to Woffu MCP by usefulapi are When I Work MCP by usefulapi, Employment Hero Payroll MCP by usefulapi, intelliHR MCP by usefulapi, Bilflo 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.
- [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.
- [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.
- [Bilflo MCP by usefulapi](https://ai-powered.com/mcp/bilflo-mcp-by-usefulapi): Bilflo 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.
- [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.
- [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/woffu-mcp-by-usefulapi
