Log inSubmit server
MCP FactorialHR logo

MCP FactorialHR

Manage FactorialHR workforce data through hierarchical MCP tools for employees, leave, attendance, projects, recruiting, and more.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP FactorialHR

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-factorialhr": {
      "command": "npx",
      "args": [
        "-y",
        "@t4dhg/mcp-factorial"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 14 tools correctly (25d ago).

Overview

MCP FactorialHR MCP server exposes FactorialHR workforce operations through 14 hierarchical MCP tools organized by category. It supports employee, team, location, leave, attendance, project, training, ATS, document, contract, work-area, job-catalog, and payroll workflows. Most categories include read and write actions, while payroll, contracts, and job catalog operations are read-only. Use it when an AI assistant needs controlled access to FactorialHR data; document downloads require OAuth2.

Use cases

  • List and search employee records
  • Create and approve time-off requests
  • Log employee attendance and working hours
  • Manage projects, tasks, and project time
  • Review recruiting candidates and applications

Key features

  • Hierarchical category tools with action-based operations
  • Employee, team, leave, attendance, and project management
  • Training, ATS, document, and work-area operations
  • Read-only payroll, contract, and job-catalog access
  • Confirmation requirements for high-risk writes
  • Audit logging for write operations

Tools14

What MCP FactorialHR lets your agent do. Expand a tool for its parameters.

Verified live~5.5k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

5/5 checks healthy over the last 44d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 4d ago via OSV.dev · @t4dhg/mcp-factorial (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars3Stargazers on the source repository.
npm downloads221Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed14Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP FactorialHR works

What the MCP FactorialHR MCP server does

MCP FactorialHR MCP server connects AI assistants to FactorialHR through category-based tools. Rather than exposing every operation as a separate tool, it groups related actions behind tools such as factorial_employees, factorial_time_off, factorial_attendance, factorial_projects, factorial_training, factorial_ats, and factorial_payroll. The factorial_discover tool helps identify available categories and actions.

The available areas cover employee records, teams, locations, contracts, leave, attendance, documents, job roles and levels, projects, training, work areas, recruiting, and payroll. Supported operations include listing, retrieving, searching, creating, updating, deleting, approving, rejecting, archiving, and other category-specific actions. Payroll, contracts, and job catalog capabilities are read-only, so the server does not provide write operations for those areas.

How it works

Each category tool accepts an action value along with the parameters required for that operation. For example, employee actions can list, retrieve, search, create, update, or terminate records. Leave actions can manage requests and approvals, while attendance actions include clock-in, clock-out, audits, status checks, and time logging.

Attendance uses the company’s local time and accepts HH:MM values. The server does not convert these times between time zones. Records written through the API are marked with source: "api", distinguishing them from live clock activity in FactorialHR. The declared working period is separate from entry metadata such as creation time and input source, which FactorialHR controls.

Write operations include safety controls, and high-risk actions require explicit confirmation. Write activity is logged with timestamps and context, providing an audit trail for debugging and review.

Setup and configuration

The project targets Node.js 18 or later and is published as the @t4dhg/mcp-factorial npm package. Consult the repository documentation for the exact authentication and client configuration steps before deployment.

Document downloads have an additional requirement: they require OAuth2.

Tools and capabilities

MCP FactorialHR MCP server provides these category tools:

  • factorial_employees for employee records
  • factorial_teams and factorial_locations for organizational data
  • factorial_time_off and factorial_attendance for leave and working-time records
  • factorial_projects, factorial_training, and factorial_work_areas
  • factorial_ats for job postings, candidates, applications, and hiring stages
  • factorial_documents for folders, documents, and downloads
  • factorial_contracts, factorial_job_catalog, and factorial_payroll for read-only employment and compensation data

This places the MCP FactorialHR MCP server in the Workplace & Productivity category. It fits assistants that need to query or modify operational HR records while keeping sensitive or high-impact changes subject to confirmation.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP FactorialHR

MCP FactorialHR is an MCP server that connects AI assistants to FactorialHR for employee, team, leave, attendance, project, training, recruiting, document, contract, and payroll work. Its main tools are hierarchical category tools such as factorial_employees, factorial_time_off, factorial_attendance, factorial_projects, factorial_ats, and factorial_payroll, plus factorial_discover for finding act…

It identifies the npm package as @t4dhg/mcp-factorial and requires Node.js 18 or later; consult the repository for the exact installation and client configuration procedure.

It describes the project as MCP-compatible and mentions AI assistants such as Claude, but it does not provide Cursor-specific setup instructions.

No, payroll operations are read-only. The payroll tool can list or retrieve supplements, tax identifiers, and family situations, but the documented payroll capabilities do not include creating, updating, or deleting payroll data.

Yes, document downloads require OAuth2.

Related MCP servers

All in Workplace & Productivity All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP FactorialHR AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mcp-factorialhr?style=directory)](https://allmcps.com/mcp/mcp-factorialhr)
HTML Embed
<a href="https://allmcps.com/mcp/mcp-factorialhr"><img src="https://allmcps.com/api/badge/mcp-factorialhr?style=directory" alt="MCP FactorialHR on AllMCPs" /></a>