Freshteam MCP. Manage employee data, applicants, and time off from your agent.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Freshteam MCP Server. Manage HR operations, track job applicants, and handle employee records directly through your AI client. This server connects to your Freshworks HRIS, letting you list employees, check time-off requests, and create new records using natural conversation.
What your AI agents can do
Check hris status
Verifies the connection status to the HRIS API.
Create employee record
Adds a new employee record to the HR directory.
Get applicant details
Retrieves a candidate's profile and application status.
Runs check_hris_status to confirm your API connection is active and ready for use.
Uses create_employee_record to add a new employee to the HR directory.
Retrieves detailed candidate information and application status using get_applicant_details.
Pulls specific metadata for an existing employee using get_employee_details.
Retrieves metadata about active job openings using get_job_posting_details.
Retrieves a list of all configured departments and organizational units using list_departments.
Retrieves a list of all current employees and their basic metadata using list_employees.
Retrieves a list of candidates who applied for specific roles using list_job_applicants.
Retrieves a list of all active job openings currently posted using list_job_postings.
Retrieves a list of predefined job roles within the company structure using list_job_roles.
Retrieves a list of all physical office branches and locations using list_office_branches.
Retrieves a list of submitted leave requests and current time-off balances using list_time_off_requests.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Freshteam MCP Server: 12 Tools for HR Management
Use these 12 tools to manage employee records, track candidates, and handle time-off requests directly through your AI agent.
019d75a0check hris status
Verifies the connection status to the HRIS API.
019d75a0create employee record
Adds a new employee record to the HR directory.
019d75a0get applicant details
Retrieves a candidate's profile and application status.
019d75a0get employee details
Gets specific metadata about an existing employee.
019d75a0get job posting details
Retrieves detailed information about an active job opening.
019d75a0list departments
Lists all configured HR departments.
019d75a0list employees
Lists all current employees in the system.
019d75a0list job applicants
Lists candidates who applied for a specific job.
019d75a0list job postings
Lists all active job openings.
019d75a0list job roles
Lists predefined job roles used in the company.
019d75a0list office branches
Lists all physical office locations.
019d75a0list time off requests
Lists submitted leave requests and time-off balances.
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 Freshteam, 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
Freshteam MCP Server
Your AI client connects to your Freshworks HRIS via this server, letting you handle employee records and recruitment stuff right from your agent environment. You don't have to switch tabs to manage core HR data.
check_hris_status confirms your API connection is up and running, so you know your data's ready.
list_departments gives you a list of every configured HR department and organizational unit.
list_employees pulls up all current employees and their basic metadata.
create_employee_record adds a brand-new employee record to the HR directory.
list_office_branches lets you see every physical office location.
list_job_roles retrieves all the predefined job roles the company uses.
get_employee_details pulls specific metadata for any existing employee.
list_time_off_requests lists submitted leave requests and shows current time-off balances.
get_applicant_details pulls detailed info and application status for any candidate.
list_job_postings gets metadata for all active job openings.
get_job_posting_details pulls specific details about a single job opening.
list_job_applicants retrieves a list of candidates who applied for a specific role.
list_job_applicants also pulls up a list of candidates who applied for a specific role.
How Freshteam MCP Works
- 1 Subscribe to the server on the Vinkius Marketplace.
- 2 Enter your Freshteam Domain prefix and API Key into your client settings.
- 3 Direct your AI agent to perform the required HR task (e.g., 'List all employees in the Marketing department').
The bottom line is, your AI agent runs the API calls to your HRIS, and you get the data back in natural conversation.
Who Is Freshteam MCP For?
HR Managers, Recruiters, and Department Heads. If your job involves tracking who works where, managing time off, or processing job applications, this server cuts out the dashboard clicks. It gives you real-time data access without ever leaving your chat window.
Checks employee profiles or monitors team structures to verify roles and department assignments.
Gets a real-time overview of job postings and accesses the full applicant pipeline for specific roles.
Monitors team structures and checks time-off requests across their direct reports.
What Changes When You Connect
- See an employee's profile or time-off status instantly by asking for it. Instead of navigating through multiple dashboards, your AI agent uses
get_employee_detailsorlist_time_off_requeststo pull the exact information you need. - Keep your hiring pipeline visible. You can ask your agent to run
list_job_postingsand then drill down intolist_job_applicantsto get a roster of every candidate for a specific role. - Onboard new hires with precision. Use
create_employee_recordto add a new person andlist_departmentsto confirm their placement in the right organizational unit. - Map your company structure instantly. Use
list_departmentsandlist_office_branchesto confirm where a job role belongs, ensuring data consistency across your records. - Access job role definitions. Running
list_job_rolesgives you a master list of what job types exist, which is critical when creating or updating employee records. - Avoid manual data fetching. Everything—from checking the connection status with
check_hris_statusto listing job applicants withlist_job_applicants—happens in a single conversational turn.
Real-World Use Cases
The New Hire Setup
A manager needs to onboard 'Sarah Connor'. She asks her agent: 'Create an employee record for Sarah Connor.' The agent runs create_employee_record. Then, she asks the agent to run list_job_roles to assign her the correct role, and finally, she uses list_departments to confirm her department. Done.
Checking Team Availability
You need to know if the whole Marketing team can take next Friday off. You ask your agent to run list_time_off_requests and filter by the Marketing department. The agent returns the current leave status and available balances, letting you approve coverage instantly.
Reviewing a Job Opening's Candidates
A recruiter needs to know who applied for the 'Senior Dev' role. They prompt their agent with: 'List job applicants for Senior Dev.' The agent runs list_job_applicants and gives the full candidate list. They then use get_applicant_details on one name to see the full resume status.
Validating Company Structure
A department head is moving a team. They ask their agent to run list_office_branches and list_departments to get the current list of valid locations and departments. This ensures they don't assign a person to a non-existent branch or department.
The Tradeoffs
Guessing Employee IDs
Manually searching through a complex dashboard or spreadsheet for an employee's ID number, risking using the wrong person's data.
→
Just ask your agent to use get_employee_details on the person's name or email. The agent finds the correct ID and provides the profile data without you having to click through any screens.
Forgetting to Check Time Off
Approving a leave request without checking the employee's remaining leave balance, which leads to denied requests and confusion.
→
Always run list_time_off_requests before approving leave. This tool shows both the request status and the employee's current leave balance, ensuring you manage coverage correctly.
Ignoring the Source of Truth
Using an outdated spreadsheet or a localized team list for critical data like job roles or department names.
→
Use list_job_roles or list_departments to get the official, real-time list directly from the system. This keeps all your data consistent.
When It Fits, When It Doesn't
Use this server if your workflow requires interacting with specific, structured HR data—like listing employees, tracking time off, or managing job applicants. It's perfect for automating discrete tasks: 'Get the status of X' or 'Create record for Y.'
Don't use this if you're trying to analyze trends or write reports based on aggregated data (e.g., 'What is the average salary by department?'). For that, you need a dedicated BI or reporting tool. If you just need to see what data exists, use list_employees or list_departments. This tool is for action, not analysis.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Freshteam. 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
Manually checking employee status across different HR portals is a huge time sink.
Right now, if you need to know if Jane Smith is active, or what her department is, you have to jump between the main HRIS dashboard, the time-off calendar, and the departmental directory. You pull up one screen, copy the ID, switch tabs, and paste it somewhere else. It's a lot of clicking, and you're always worried you missed a field or used the wrong date.
With the Freshteam MCP Server, you just tell your agent: 'Show me Jane Smith's full profile.' The agent runs `get_employee_details` and returns everything—her status, her department, her manager—in a single, clean response. The clicks disappear.
Freshteam MCP Server: Get employee data and manage applicants.
The old way involved submitting forms and waiting for manual review to get a new employee added. You'd fill out a form, send it to HR, wait for them to process it, and then wait for the system to update. It was slow, and you were never sure when it was actually done.
Now, you tell your agent to `create_employee_record`. The agent handles the API call and confirms the ID immediately. You're updating the system, not waiting for a person to update the system.
Common Questions About Freshteam MCP
How do I check if the Freshteam MCP Server is connected? +
You run check_hris_status. This tool confirms your API connection to the HRIS is active, letting you know if your agent can actually talk to the system.
Can I list job applicants using the list_job_applicants tool? +
Yes, list_job_applicants lists candidates who applied for a specific job opening. It gives you a list of names and application details for a specific role.
How do I create a new employee record with the create_employee_record tool? +
You give the agent the required details (name, email, etc.), and the agent executes create_employee_record. It confirms the creation and gives you the new Employee ID.
Can I see my team's time-off requests using the list_time_off_requests tool? +
Yes, list_time_off_requests gives you a roster of leave requests and shows current leave balances for the employees you specify.
What does list_employees do? +
list_employees gives you a list of all current employees in the company. It's the primary tool for getting a roster.
How can I list all office locations using the list_office_branches tool? +
The list_office_branches tool returns a list of all configured physical office locations. You can use this data to map job postings or filter employee records by branch location.
What is the difference between list_job_roles and list_job_postings? +
The list_job_roles tool provides a fixed list of defined job titles (e.g., 'Product Manager'). The list_job_postings tool shows actual, currently active job openings that match those roles.
Does the create_employee_record tool require specific metadata? +
Yes, the create_employee_record tool requires key metadata like the employee's full name, email, and department ID. Providing this data ensures the record integrates correctly into your HR directory.
How do I get an API Key for Freshteam? +
Log in to your Freshteam account, click on your Profile Icon in the top right corner, select 'API Settings', and copy 'Your API Key'.
What is my 'Domain prefix'? +
Your domain prefix is the first part of your Freshteam URL (e.g. if your URL is 'acme.freshteam.com', the prefix is 'acme').
Can I see all applicants for a specific job? +
Yes! First use the 'list_job_postings' tool to get the Job ID, then use 'list_job_applicants' with that ID to see everyone who applied.
Is it possible to add a new employee via the agent? +
Yes, use the 'create_employee_record' tool. Provide the first name, last name, and official email to instantly add them to your HRIS directory.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Paylocity
Manage payroll and HR via Paylocity — list employees, track earnings, and audit benefits setup directly from any AI agent.
Deel
Manage global contracts, team members, invoices, payments, time-off, and expenses — global HR for AI agents.
InfoVetted
Screen and verify candidate backgrounds with employment checks, education verification, and criminal record searches.
You might also like
CoinCap
Get real-time cryptocurrency prices, market data, exchange rankings and OHLCV candles — no API key required.
Limble CMMS
Keep your equipment running with preventive maintenance scheduling, work order management, and asset tracking for facility teams.
UniOne
Send transactional and bulk emails with high deliverability, detailed analytics, and infrastructure that handles millions of messages.