← Index

MCP FactorialHR

io.github.t4dhg/mcp-factorial·v7.1.0·Calendar & Time
Quality Score
88
/100

Full CRUD MCP server for FactorialHR: employees, teams, time off, projects, ATS, payroll.

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "mcp-factorial": {
      "command": "npx",
      "args": [
        "-y",
        "@t4dhg/mcp-factorial"
      ],
      "env": {
        "FACTORIAL_API_KEY": "<your-factorial_api_key>",
        "FACTORIAL_API_VERSION": "<factorial_api_version>",
        "FACTORIAL_TIMEOUT_MS": "<factorial_timeout_ms>",
        "FACTORIAL_MAX_RETRIES": "<factorial_max_retries>",
        "DEBUG": "<debug>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "mcp-factorial": {
      "command": "npx",
      "args": [
        "-y",
        "@t4dhg/mcp-factorial"
      ],
      "env": {
        "FACTORIAL_API_KEY": "<your-factorial_api_key>",
        "FACTORIAL_API_VERSION": "<factorial_api_version>",
        "FACTORIAL_TIMEOUT_MS": "<factorial_timeout_ms>",
        "FACTORIAL_MAX_RETRIES": "<factorial_max_retries>",
        "DEBUG": "<debug>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y @t4dhg/mcp-factorial
§02  Environment variables
FACTORIAL_API_KEY
requiredsecret

API key from FactorialHR (Settings > API Keys)

FACTORIAL_API_VERSION

API version (default: 2025-10-01)

FACTORIAL_TIMEOUT_MS

Request timeout in milliseconds (default: 30000)

FACTORIAL_MAX_RETRIES

Maximum retry attempts (default: 3)

DEBUG

Enable debug logging (default: false)

§03  MCP Quality Score  ·  methodology
freshness
18
completeness
20
installability
25
documentation
15
stability
10
§04  Alternatives in Calendar & Time