Freshteam Connector for AI agents.
12 live capabilities
Manage employee records and track job applicants in your HR software.
Waiting for input…
Why people use Freshteam
Freshteam for Automated HR Records Management
With this Connector, you can pull that data into your current conversation. You can ask about a specific hire, see who's out of the office today, or grab a list of open roles without ever touching the dashboard. You get the answers you need exactly when you need them.
What Vinkius changes
You get a conversational interface for your entire HR and recruitment database.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Checking coverage for a busy week
An HR manager asks the agent who is on leave next week and uses list_time_off_requests to see the schedule without opening a spreadsheet.
- Real-world use case 02
Reviewing a high-priority candidate
A recruiter asks for the profile of a specific applicant and uses get_applicant_details to see their history and status instantly.
- Real-world use case 03
Onboarding a new hire
An admin tells the agent to add a new person to the team and uses create_employee_record to update the directory in one step.
Complete set · 12capabilities
The complete Freshteam capability set.
These are the exact actions your AI can choose when you ask it to work with Freshteam.
01—04
4 capabilities in this set.
Part of 12 available through Freshteam.
- 01 Capability
Check hris status
Verify your API connection is active. This ensures your agent can talk to your HR data without errors.
- 02 Capability
List time off requests
List all leave requests. This helps you monitor who's away and manage workforce coverage.
- 03 Capability
Create employee record
Create a new employee record. Use this to add a new hire to your directory through a simple command.
- 04 Capability
Get job posting details
Get specific information about a job. Use this to see the details of a particular opening.
05—08
4 capabilities in this set.
Part of 12 available through Freshteam.
- 05 Capability
List job applicants
List all candidates for a role. This helps you see the entire hiring pipeline for a specific position.
- 06 Capability
List office branches
List all office locations. Use this to see where your teams are physically located.
- 07 Capability
List departments
List all HR departments. This gives you a quick look at your company's internal structure.
- 08 Capability
List employees
List all employees in your directory. Use this to get a high-level view of your entire workforce.
09—12
4 capabilities in this set.
Part of 12 available through Freshteam.
- 09 Capability
List job postings
List all active job openings. This lets you see every role you're currently hiring for.
- 10 Capability
List job roles
List all job roles. Use this to see the variety of positions available in your company.
- 11 Capability
Get applicant details
Pull a specific candidate's profile. Use this to see a person's history and status quickly.
- 12 Capability
Get employee details
Get metadata for a specific employee. This helps you find details on a staff member's role or status.
Set up in minutes
One URL. Then ask Freshteam to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Freshteam from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_lNHtSaXMT5SaqCzoAz5L9PyKnb06EFHSHZaSIjrZ/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Freshteam, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Freshteam for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_lNHtSaXMT5SaqCzoAz5L9PyKnb06EFHSHZaSIjrZ/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Freshteam URL.
- Step 03
Save and start
Save the connection and enable Freshteam in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"freshteam": {
"url": "https://edge.vinkius.com/vk_preview_lNHtSaXMT5SaqCzoAz5L9PyKnb06EFHSHZaSIjrZ/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Freshteam
Open Agent mode in chat and ask: "Using Freshteam, help me...". 12 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"freshteam": {
"url": "https://edge.vinkius.com/vk_preview_lNHtSaXMT5SaqCzoAz5L9PyKnb06EFHSHZaSIjrZ/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Freshteam
Ask Copilot: "Using Freshteam, help me...". 12 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"freshteam": {
"url": "https://edge.vinkius.com/vk_preview_lNHtSaXMT5SaqCzoAz5L9PyKnb06EFHSHZaSIjrZ/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Freshteam
Open Cascade and ask: "Using Freshteam, help me...". 12 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"freshteam": {
"url": "https://edge.vinkius.com/vk_preview_lNHtSaXMT5SaqCzoAz5L9PyKnb06EFHSHZaSIjrZ/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Freshteam
Ask Cline: "Using Freshteam, help me...". 12 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add freshteam --transport http "https://edge.vinkius.com/vk_preview_lNHtSaXMT5SaqCzoAz5L9PyKnb06EFHSHZaSIjrZ/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Freshteam
Ask Claude: "Using Freshteam, show me...". 12 tools are ready
Where the request belongs
Work Freshteam can move forward.
For HR managers who are tired of manual data entry and recruiters who need to see their hiring pipeline without clicking through five different menus. It's for the person who needs to know who's in the office and who's on leave, right now.
HR Manager
Manages employee records and time-off requests without leaving their primary workspace.
Recruiter
Tracks job applicants and job postings to keep the hiring pipeline moving on a daily basis.
Department Head
Pulls organizational data and team structures to plan projects and manage headcount.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsBeisen (iTalentX)
Comprehensive HR cloud platform. manage employees, attendance, and recruitment via AI.
Humanity
Manage workforce scheduling, employee shifts, and team communication via Humanity. list employees, manage locations, and track shifts directly from any AI agent.
Troops
Automate HR and recruitment workflows via Troops. manage job offers, candidates, contracts, and timesheets directly from your AI agent.
BambooHR
Human Resources management platform. organize employee data, track time off, and audit HR workflows via AI.
Homerun
Automate recruitment workflows via Homerun. manage job applications, track candidates, and oversee vacancies directly from any AI agent.
WebHR
Manage employees, attendance, and recruitment on WebHR with AI agents.
Bring your own AI
Change the model, client or framework. Keep Freshteam connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Freshteam.
The practical details behind the request, access and result.
Can I use Freshteam MCP to see who's on vacation?
Yes, you can ask your agent to list leave requests, which pulls data from Freshteam to show you who's away and helps you manage team coverage.
How does Freshteam MCP help with hiring?
It lets your agent see all active job postings and the list of applicants for each role in one place, making it easier to track your recruitment pipeline.
Can I add new employees using this?
Yes, you can tell your agent to create a new employee record and it will add them to your Freshteam directory automatically.
Does Freshteam MCP work with my current AI client?
It works with any MCP-compatible client like Claude, Cursor, or Windsurf once you connect it via the Vinkius marketplace.
Is my HR data safe with this?
The Connector only accesses the data your agent needs to answer your questions based on the permissions in your Freshteam API key.
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' capability 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' capability. Provide the first name, last name, and official email to instantly add them to your HRIS directory.
One connection away
Give your agent a direct line to Freshteam.
Connect Freshteam once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available