Factorial MCP. Manage HR data, time, and documents via chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Factorial MCP Server connects your AI client directly to your HR system. It lets you manage employee data, track time, and handle documents without opening the Factorial dashboard.
Use it to list employees, check leave requests, review payslips, or audit company policies via natural conversation.
What your AI agents can do
Clock in
Records the start time for an employee's work shift.
Clock out
Records the end time for an employee's work shift.
Get employee
Fetches the profile and details for one specific Factorial employee using their ID.
Retrieves a specific employee's profile, contact information, and role using their unique ID.
Provides a full list of all employees registered in the system, allowing you to search by department or role.
Lists all defined teams and members, helping you understand organizational groupings and reporting lines.
Fetches all approved and pending leave requests for a specified year, helping you gauge team availability.
Lists payslips for a given month and year, verifying salary records and financial history.
Searches and retrieves specific HR policies or internal documents from the company's document repository.
Retrieves detailed shift schedules and allows you to clock in or clock out for time tracking.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Factorial MCP Server: 12 Tools for HR Data Management
Use these 12 tools to gather employee lists, track time, manage leave requests, and audit payroll data through your AI agent.
019d7596clock in
Records the start time for an employee's work shift.
019d7596clock out
Records the end time for an employee's work shift.
019d7596get employee
Fetches the profile and details for one specific Factorial employee using their ID.
019d7596get me
Retrieves the current organizational identity and company configuration details.
019d7596list documents
Lists and searches for company-wide documents and stored HR policies.
019d7596list employees
Gets a complete list of all active employees in the Factorial system.
019d7596list folders
Lists all available document folders within the company repository.
019d7596list holidays
Retrieves a list of official public holidays for a specified year.
019d7596list leaves
Lists all recorded leave and absence requests for a given year.
019d7596list payslips
Gets a list of payslips available for a specific month and year.
019d7596list shifts
Retrieves all recorded shift schedules for a specific month and year.
019d7596list teams
Lists all departments and teams defined within the Factorial HR system.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Factorial, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Connect your AI client to the Factorial MCP Server. You can manage employee data, track time, and pull documents without opening the Factorial dashboard. You'll use these tools to list employees, check leave requests, review payslips, or audit company policies just by talking to your agent.
Getting Employee Details: You can use get_employee to pull a specific employee's profile, contact info, and role using their unique ID. You can also use list_employees to pull a full roster of everyone active in the system, searching by department or role. You can check out the team structure by using list_teams to list all departments and members.
Time and Attendance: You can use clock_in to record the start time for a shift, and clock_out to record the end time. You can check all recorded shift schedules for a specific month and year using list_shifts. To see absences, you can use list_leaves to pull all recorded leave and absence requests for a given year.
You can also pull official public holidays for a specific year with list_holidays.
Payroll and Records: You can use list_payslips to get a list of payslips available for a specific month and year, letting you verify salary records and financial history.
Documents and Policies: You can use list_documents to search and pull company-wide documents and stored HR policies. You can also use list_folders to list all available document folders within the company repository.
System Overview: You can use get_me to pull the current organizational identity and company configuration details. You can also use list_tech_teams to list all departments and teams defined within the Factorial HR system.
How Factorial MCP Works
- 1 Subscribe to the Factorial server and enter your API Key in the client settings.
- 2 Tell your AI agent what you need (e.g., 'What are Jane Doe's leave requests for 2025?').
- 3 The agent calls the necessary tool (like
list_leaves) and returns a clean, conversational answer with the data.
The bottom line is you manage HR data and workflows by talking to your AI client, instead of clicking through the Factorial dashboard.
Who Is Factorial MCP For?
HR Managers who need to check employee directories or approve leave without logging into the Factorial dashboard. Team Leads who need quick team availability checks or shift audits. Finance teams who need to verify payslip availability or audit company metadata in real-time. Operations teams that manage company documents and organizational structures via chat.
Uses this to track leave requests and monitor employee directories without opening the Factorial dashboard.
Checks team availability and audits shift schedules by asking the AI agent questions.
Verifies payslip availability and audits company metadata in real-time to track payroll data.
Retrieves HR policies and verifies organizational structures by asking the AI agent to search documents.
What Changes When You Connect
- Check team availability and audit shifts instantly. Instead of navigating the shift calendar, use
list_shiftsto see team rotations and coverage for any month. - Track leave and holidays without logging in. Use
list_leavesorlist_holidaysto quickly see who is out and when, keeping your team availability metrics current. - Audit payroll records on demand. Running
list_payslipslets you verify compensation data for specific months, eliminating the need to download and compare multiple PDFs. - Discover HR policies fast. Use
list_documentsto search and retrieve specific policies (like 'Remote Work Policy') across all stored company folders, bypassing manual folder navigation. - Build employee profiles on the fly.
get_employeelets you pull specific contact details, manager info, or hiring dates for one person, faster than opening their profile page. - Manage time tracking in context. Use
clock_inandclock_outdirectly through the agent to log shifts and keep time records accurate.
Real-World Use Cases
Checking Team Availability for a Project Launch
A Project Manager needs to know if the whole marketing team is available next month. They ask their agent: 'Show me leave and shifts for the marketing team in October.' The agent uses list_leaves and list_shifts to synthesize the data, showing the manager exactly who is free and who is out, preventing scheduling conflicts.
Verifying Employee Status Before a Meeting
An HR Manager needs to confirm Jane Doe's current role and manager. Instead of searching the internal directory, they ask their agent to run get_employee on Jane Doe's ID. The agent replies with her full profile, making the meeting preparation instant and reliable.
Auditing Payroll for Compliance
A Finance Analyst needs to verify the payroll data for Q1. They ask the agent to list_payslips for Q1. The agent provides a list of payslips and financial metadata, allowing the analyst to confirm that all records are accounted for and accurate.
Finding a Specific HR Policy
An Operations Specialist needs the '2024 PTO Policy' but doesn't know where it lives. They ask the agent to list_documents. The agent searches the company repository and returns the exact file name and link, solving the document discovery problem.
The Tradeoffs
Manual Data Collection
Downloading separate CSVs for employees, then downloading a separate spreadsheet for paid leave, and finally cross-referencing them in Excel to find the total team capacity.
→
Ask your agent to combine the data. Use list_employees to get the roster, then ask for list_leaves for the desired period. The agent handles the merge and gives you a single answer.
Over-relying on Dashboards
Logging into the Factorial portal, navigating through five different tabs (Payroll, Time, Leaves, People) just to answer a simple question about John Smith.
→
Use the agent. Run get_employee first, then follow up with list_shifts or list_leaves. The conversation keeps the data focused and immediate.
Forgetting Time Boundaries
Assuming that all recorded shifts are available. Trying to manually check shift logs that might be incomplete or for the wrong year.
→
Always specify the time frame. Use list_shifts and list_leaves together, making sure you specify the exact year and month in your query.
When It Fits, When It Doesn't
Use this server if your job requires synthesizing data from multiple HR sources (e.g., 'Show me Jane's leave and her shifts'). It excels when you need to correlate employee data (get_employee) with time records (list_leaves, list_shifts) or documents (list_documents). Don't use it if you just need a single piece of static data (e.g., 'What is the company name?'). For that, the get_me tool is enough. This server is for complex, multi-step queries that need an immediate, synthesized answer, not just a raw list of data points.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Factorial. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 12 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
HR data shouldn't require logging into five different dashboards.
Right now, checking a team's availability means logging into Factorial, clicking the 'Team' tab, then navigating to the 'Leave' section. If you need to see shift coverage, you have to repeat that process in a different section. It's copy-pasting IDs and jumping between screens just to get a full picture.
With this MCP server, you just talk to your agent. You ask, 'Who is out next month and who is scheduled?' The agent uses `list_leaves` and `list_shifts` and gives you a single, readable answer. You get the answer without the clicking.
List Payslips: Get payroll data instantly.
Checking payroll used to mean finding the right month in the file storage, locating the correct employee folder, and downloading a PDF. You'd have to do this for every single person you needed to verify.
Now, ask the agent to run `list_payslips` for the quarter you need. It gives you a list of available payslips and metadata immediately. You get the audit trail without the paperwork.
Common Questions About Factorial MCP
How do I use the `list_employees` tool to find a person's contact info? +
You first run list_employees to get the list of IDs. Then, pass the specific ID to get_employee to retrieve their full contact details and role.
Can I check team availability using the `list_leaves` tool? +
Yes. You specify the year and the team context, and the agent uses list_leaves to aggregate all approved time off, giving you a team capacity overview.
What is the difference between `list_shifts` and `list_leaves`? +
Shifts (list_shifts) tracks scheduled work hours. Leaves (list_leaves) tracks approved time off when the employee is not expected to work. They track two different types of absence.
How do I find company policies using `list_documents`? +
You use list_documents and ask for a policy name (e.g., 'PTO policy'). The agent searches the full company repository and returns the specific file details.
How do I clock in or clock out using `clock_in` and `clock_out`? +
You simply instruct your agent to 'Clock me in for my shift.' The agent executes the appropriate tool and records the time stamp.
How do I check salary history or payslips using the `list_payslips` tool? +
The list_payslips tool fetches pay records for a specific year and month. You pass the required year and month to get a full list of payslips, allowing you to audit compensation details and track financial history.
What is the difference between `list_employees` and `get_employee`? +
Use list_employees to get a complete roster of all employees. If you know the specific ID, use get_employee to pull the full profile details for just that single person, saving you time and API calls.
How can I check organizational structure using `list_teams`? +
The list_teams tool provides a list of all registered departments or teams. This lets you map out the entire organizational structure and understand who belongs to which functional group.
Can my agent list all leave requests for the current year in Factorial? +
Yes. Use the 'list_leaves' tool. You can specify the 'year' parameter, and the agent will fetch all absence and holiday requests, allowing you to track team availability flawlessly.
How do I check the shift schedule for a specific month via chat? +
Use the 'list_shifts' tool. Provide the 'year' and 'month' (numeric). The agent will retrieve the detailed scheduling information, providing you with a clear view of operational coverage.
Can I audit payslip availability through the agent? +
Absolutely. Use the 'list_payslips' tool for a target year and month. Your agent will verify which employees have available compensation records without you needing to manually navigate the payroll section.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Fibery
Connect your Fibery workspace to automate work management — query entities, create tasks, and manage comments directly from your AI agent.
Brushfire
Manage events and attendees via Brushfire — track registrations, check-in guests, and monitor orders directly from any AI agent.
Linkwarden
Manage your bookmarks and web archives with Linkwarden — organize collections, preserve pages, and manage links directly from your AI agent.
You might also like
Vercel
Bring your Vercel deployment infrastructure into chat. Control project domains, trigger manual builds, and inspect deployment status natively.
Pylon
Automate B2B support and CRM via Pylon — manage issues, accounts, and knowledge bases with AI.
Ayuntamiento de Zaragoza
Access Zaragoza's open data, city services (Open311), collaborative maps, and appointment booking directly through AI.