Factorial HR MCP Server

A comprehensive Model Context Protocol (MCP) server that provides AI assistants like Claude with full access to FactorialHR. Manage employees, teams, time off, projects, training, recruiting, and more - all with built-in safety guardrails. It runs locally over stdio via the published package.

People who work with employee directory, factorial and factorialhr and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-08 · ★ 3 · #11 OF 41 MAINTAINED FILESYSTEM · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install Factorial HR

before you install - you'll need

Set FACTORIAL_API_KEY, FACTORIAL_OAUTH_CLIENT_ID, FACTORIAL_OAUTH_CLIENT_SECRET, FACTORIAL_OAUTH_REFRESH_TOKEN before connecting.

Claude Code

claude mcp add t4dhg-mcp-factorial -- npx -y @t4dhg/mcp-factorial

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "t4dhg-mcp-factorial": {
      "command": "npx",
      "args": [
        "-y",
        "@t4dhg/mcp-factorial"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @t4dhg/mcp-factorial - published under the repo owner's npm scope (@t4dhg)

registry namespace io.github.t4dhg is GitHub-verified and matches the repo owner

03 · What Factorial HR can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Limitations (from the README)

- Refresh tokens expire after 1 week - you'll need to repeat steps 2-3 if it expires - The MCP server automatically refreshes access tokens using the refresh token - If document downloads suddenly stop working, your refresh token has likely expired

04 · Who maintains Factorial HR

MCP FactorialHR is maintained by t4dhg. We track 2 MCP servers from t4dhg - 2 actively maintained, 3 combined GitHub stars, oldest repo from Dec 2025.

05 · Facts

repository: github.com/t4dhg/mcp-factorial
website: https://github.com/t4dhg/mcp-factorial#readme
category: filesystem - ranked #11 of 41 actively-maintained filesystem servers as of 2026-09-18.
registry: io.github.t4dhg/mcp-factorial (active, first published 2025-12-30 · 2 versions)
packages: npm:@t4dhg/mcp-factorial

06 · Factorial HR FAQ

What is Factorial HR?

Is Factorial HR still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-08. We re-verify nightly.

How do I install Factorial HR?

Run `npx -y @t4dhg/mcp-factorial`. The README documents 4 environment variables (FACTORIAL_API_KEY, FACTORIAL_OAUTH_CLIENT_ID, FACTORIAL_OAUTH_CLIENT_SECRET…) to set first. Set FACTORIAL_API_KEY, FACTORIAL_OAUTH_CLIENT_ID, FACTORIAL_OAUTH_CLIENT_SECRET, FACTORIAL_OAUTH_REFRESH_TOKEN before connecting. You can also paste the ready-made client config above.

Does Factorial HR run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Factorial HR

Alternatives to Factorial HR

Maintained filesystem servers if Factorial HR isn't the fit.

More filesystem MCP servers · Tilde · Silicon Friendly · Work OS · Document Reader · Dibs

More TypeScript MCP servers · Tago Io MCP Server · Talonic · Headless Tracker · Tampermonkey MCP · Aidemo · see all