MCP server

The Factorial MCP server lets an AI assistant securely act on your behalf inside Factorial. Ask your assistant to clock you in, check your tasks, request time off, or look up a colleague, and it does it in your Factorial account, using your own permissions.

It is a hosted Model Context Protocol (MCP) server, so there is nothing to install or run. You connect once with a single OAuth login and your assistant is ready to go.

Endpoint: https://mcp.factorialhr.com
Transport: Streamable HTTP
Auth: OAuth 2.0 (with Dynamic Client Registration)

Why use it

One-click connection. Add the server to your AI client and log in with your Factorial account. No API keys to copy, no tokens to manage.
It acts as you. Every action runs under your identity and respects your existing Factorial permissions. The assistant can never do anything you couldn't do yourself.
Natural language. Skip the menus. "Clock me in", "what's on my plate today?", or "request Friday off" just work.

Connect your AI assistant

❓
Why isn't Factorial in my assistant's connector directory?
You won't find Factorial in the built-in connector marketplaces of Claude, ChatGPT, or other providers yet. Each provider has its own verification and review process, and these directories are currently saturated, so listing takes time. We are going through those processes, but you don't need to wait: any remote MCP server can be added manually by URL, and the result is exactly the same. The steps below show how.

The server works with any AI assistant that supports remote MCP connectors. The setup is the same everywhere: add a custom connector pointing at the server URL, then log in with your Factorial account.

Open your assistant's connector (or integration) settings.
Choose to add a custom connector.
Paste the server URL:

https://mcp.factorialhr.com

Confirm. Your assistant opens a Factorial login window.
Log in with your Factorial account and approve access.

That's it. The client registers itself automatically (Dynamic Client Registration), completes the OAuth flow, and the Factorial tools become available in your conversations. You only do this once; the connection is remembered.

✅
We've verified this flow end-to-end with Claude (web and desktop): open Settings → Connectors → Add custom connector and paste the URL above.
Other MCP-capable assistants (like ChatGPT, Gemini, etc) follow similar steps and should work.

Using a company (Enterprise/Team) account?

If you use Claude or ChatGPT through a company workspace (for example Claude Enterprise/Team or ChatGPT Enterprise/Team), you may find that the option to add custom connectors is disabled. This is a security measure on the provider's side: organizations can restrict which connectors their members are allowed to use.

In that case, the workspace owner or admin has to add the Factorial connector at the organization level. Once they do, it becomes available to everyone in the workspace — each person still logs in with their own Factorial account, so all actions keep running under their own permissions.

In short:

Personal account: you can add any MCP connector yourself.
Company account: if custom connectors are blocked, ask your workspace admin to add https://mcp.factorialhr.com for the organization.

What you can do

Here are the things you can ask for, with example prompts. You don't need to use these exact words, the assistant maps your intent to the right action.

Attendance

Clock in and out and check your current status. Times are handled in your location's timezone.

"Clock me in."
"Clock me out."
"Am I clocked in right now?"

Tasks

See the tasks assigned to you and create new ones.

"What tasks do I have to do?"
"Show me my in-progress tasks."
"Add a task to review the Q3 budget."

Time off

View your leaves, see which leave types are available to you, and request time off.

"What time off do I have coming up?"
"What leave types can I request?"
"Request holiday next Friday."

Employee lookup

Find a colleague by name or email.

"What's Jane Doe's email?"
"Who is [email protected]?"

Factorial One

Delegate broader questions and actions to Factorial One, Factorial's AI assistant. It can reach into policies, contracts, reports, the knowledge base, performance reviews, and more.

"What's the company remote-work policy?"
"Summarize my current contract."
"Pull the latest headcount report."

📘
Requires Factorial One
The Factorial One capability is only available if your plan includes access to Factorial One. Without it, these requests won't work, but everything else on this page still does.

Direct tools vs. Factorial One: how they connect (and what consumes credits)

The MCP server exposes two kinds of capabilities, and it's worth understanding the difference — especially if you're wondering about Factorial One credits.

Direct tools (attendance, tasks, time off, employee lookup) are plain actions against Factorial. When you say "clock me in", your assistant calls the tool, the tool performs the action in Factorial, and the result comes back. No AI runs on Factorial's side, so today these actions don't consume Factorial One credits. These tools exist to extend what Factorial One currently covers — clocking in, for example, isn't supported by Factorial One yet. Expect this to evolve: in the near future they will likely be merged into Factorial One, with every request going through it.

The Factorial One tool is different: it's a bridge between two AIs. When you ask something that goes beyond the direct tools — "summarize my contract", "what's our remote-work policy?" — your assistant hands the question over to Factorial One, Factorial's own AI assistant. Factorial One does the actual work inside Factorial (searching policies, reading reports, querying the knowledge base) and sends the answer back to your assistant, which relays it to you. It's literally one assistant talking to another.

In practice, a Factorial One request looks like this:

You → Your assistant (Claude/ChatGPT) → MCP server → Factorial One → answer flows back

Who pays for what: your assistant's "thinking" is billed by your AI provider, as always. But the work Factorial One does — the tokens it consumes to search, read, and answer — is billed as Factorial One usage on your Factorial plan. So:

Direct tools (clock in, tasks, time off, lookup): currently don't consume Factorial One credits.
Factorial One tool: consumes Factorial One credits, exactly as if you had asked Factorial One directly in the Factorial app.

Security & permissions

Every action runs as you. The server acts as the authenticated user, never as an admin or service account.
Your Factorial permissions are enforced. Factorial's own permission system is checked on every single call. If you can't do something in Factorial, the assistant can't either.
OAuth 2.0. Connecting uses standard OAuth 2.0 with refresh tokens, so the session stays valid without re-entering your password.
No stored credentials. The AI client holds only its OAuth tokens. Your Factorial password is never shared with or stored by the client.

Troubleshooting & FAQ

I can't find Factorial in my assistant's connector marketplace
That's expected — we're not listed in the provider directories yet (their verification processes are slow and saturated). Add it manually as a custom connector with the URL https://mcp.factorialhr.com. See Connect your AI assistant.

I can't add a custom connector (the option is disabled or blocked)
You're probably on a company (Enterprise/Team) plan where custom connectors are restricted by policy. Ask your workspace owner or admin to add the connector at the organization level; it will then be available to all members. See Using a company account.

Does using this consume Factorial One credits?
Only when the Factorial One capability is used. Today, clocking in, managing tasks, requesting time off, and looking up colleagues don't consume Factorial One credits. Questions delegated to Factorial One (policies, contracts, reports...) consume Factorial One credits, same as asking Factorial One directly. This may change as more capabilities move to Factorial One. See Direct tools vs. Factorial One.

"Not authorized" or "permission denied"
You're missing the Factorial permission for that action. The MCP server enforces your account's permissions, so ask your Factorial admin for access, then try again.

The connection stopped working / I'm asked to log in again
Your session expired or was revoked. Re-authenticate: remove and re-add the connector in your client's settings, then log in with your Factorial account again.

A Factorial One request didn't work
Factorial One requires that your plan includes it. If other capabilities (attendance, tasks, time off, lookup) work but Factorial One doesn't, your plan likely doesn't include Factorial One access.

Which AI assistants can I use?
Any assistant that supports remote MCP connectors. We verify the flow with Claude (web and desktop), so that's the smoothest path today. Other MCP-capable clients follow the same setup and should work too.