MCP Server

MCP FactorialHR MCP Server

Name: MCP FactorialHR MCP Server
Author: io.github.t4dhg

io.github.t4dhg/mcp-factorial

Repository Registry

What is the MCP FactorialHR MCP server?

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

How to install MCP FactorialHR

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

FACTORIAL_API_KEY
required
secret
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)

Claude Desktop

~/Library/Application Support/Claude/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": "<YOUR_FACTORIAL_API_VERSION>",
        "FACTORIAL_TIMEOUT_MS": "<YOUR_FACTORIAL_TIMEOUT_MS>",
        "FACTORIAL_MAX_RETRIES": "<YOUR_FACTORIAL_MAX_RETRIES>",
        "DEBUG": "<YOUR_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": "<YOUR_FACTORIAL_API_VERSION>",
        "FACTORIAL_TIMEOUT_MS": "<YOUR_FACTORIAL_TIMEOUT_MS>",
        "FACTORIAL_MAX_RETRIES": "<YOUR_FACTORIAL_MAX_RETRIES>",
        "DEBUG": "<YOUR_DEBUG>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-factorial": {
      "command": "npx",
      "args": [
        "-y",
        "@t4dhg/mcp-factorial"
      ],
      "env": {
        "FACTORIAL_API_KEY": "<YOUR_FACTORIAL_API_KEY>",
        "FACTORIAL_API_VERSION": "<YOUR_FACTORIAL_API_VERSION>",
        "FACTORIAL_TIMEOUT_MS": "<YOUR_FACTORIAL_TIMEOUT_MS>",
        "FACTORIAL_MAX_RETRIES": "<YOUR_FACTORIAL_MAX_RETRIES>",
        "DEBUG": "<YOUR_DEBUG>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mcp-factorial": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@t4dhg/mcp-factorial"
      ],
      "env": {
        "FACTORIAL_API_KEY": "<YOUR_FACTORIAL_API_KEY>",
        "FACTORIAL_API_VERSION": "<YOUR_FACTORIAL_API_VERSION>",
        "FACTORIAL_TIMEOUT_MS": "<YOUR_FACTORIAL_TIMEOUT_MS>",
        "FACTORIAL_MAX_RETRIES": "<YOUR_FACTORIAL_MAX_RETRIES>",
        "DEBUG": "<YOUR_DEBUG>"
      }
    }
  }
}

Claude Code

claude mcp add mcp-factorial --env FACTORIAL_API_KEY=<YOUR_FACTORIAL_API_KEY> --env FACTORIAL_API_VERSION=<YOUR_FACTORIAL_API_VERSION> --env FACTORIAL_TIMEOUT_MS=<YOUR_FACTORIAL_TIMEOUT_MS> --env FACTORIAL_MAX_RETRIES=<YOUR_FACTORIAL_MAX_RETRIES> --env DEBUG=<YOUR_DEBUG> -- npx -y @t4dhg/mcp-factorial