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

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.

📘
Verified with Claude
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.

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.

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

"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.