An astronaut overseeing a futuristic data hub
Download PDFMarkdown Version

Connect Freshteam to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Run your entire recruitment and employee lifecycle through your AI client.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

A futuristic MCP client docking bay
V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 12 capabilities

We ship only the actions that matter.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 12 available through Freshteam.

  1. 01

    Get job posting details

    Retrieves specific metadata for a single job posting.

  2. 02

    Check hris status

    Tests the connection to ensure the Freshteam API is responding.

  3. 03

    Create employee record

    Adds a new employee to your directory via your AI client.

  4. 04

    Get applicant details

    Fetches a specific candidate's profile and information.

Capability set02 / 03

05-08

4 capabilities in this set.

Part of 12 available through Freshteam.

  1. 05

    Get employee details

    Pulls detailed metadata for a specific employee.

  2. 06

    List departments

    Returns a list of all configured HR departments.

  3. 07

    List time off requests

    Shows all current employee leave and time-off requests.

  4. 08

    List job applicants

    Provides a list of candidates applied to specific roles.

Capability set03 / 03

09-12

4 capabilities in this set.

Part of 12 available through Freshteam.

  1. 09

    List office branches

    Retrieves the list of all office locations.

  2. 10

    List employees

    Generates a list of all employees in the directory.

  3. 11

    List job postings

    Shows all currently active job openings.

  4. 12

    List job roles

    Lists the various job roles defined in the system.

Real work

What teams actually run

01

Quick Candidate Screening

Ask your agent for the details of an applicant to quickly review their profile.

02

Staffing Oversight

Check which employees are currently on leave to manage team coverage.

03

Hiring Pipeline Audits

Get a list of all active job postings to see where your recruiting stands.

04

Onboarding Automation

Add new hires to the system by simply providing their details to the agent.

Automate a task

Put Freshteam to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

Freshteam works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

ClaudeClaudeChatGPTChatGPTGeminiGeminiPerplexityPerplexityGrokGrokMicrosoft CopilotMicrosoft CopilotCursorCursorVS CodeVS CodeWindsurfWindsurfJetBrainsJetBrainsClineClineLangChainLangChainVercel AI SDKVercel AI SDKLovableLovableZ.aiZ.aiRaycastRaycastQwen CodeQwen CodeKimi CodeKimi CodeLe ChatLe Chat

Building your own app? The connector is yours to use.

You don't need a client to put Freshteam to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

899ms average. Fast in production.

Freshteam is checked daily against the live service.

Daily averagePeak 1284ms
Oct 3Today
Fastest day
707ms
Slowest day
1284ms
14-day trend
Slowing+11%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 12 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Freshteam, so you can see the experience inside your AI.

It does not authenticate your account with Freshteam. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Freshteam Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_lNHtSaXMT5SaqCzoAz5L9PyKnb06EFHSHZaSIjrZ/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Freshteam capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "freshteam-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_lNHtSaXMT5SaqCzoAz5L9PyKnb06EFHSHZaSIjrZ/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? Set up Freshteam in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work Freshteam owners hand off.

This MCP is built for HR professionals and hiring teams who want to interact with their people data without switching tabs.

  • 01

    HR Managers

    They use the agent to check employee profiles and leave requests.

  • 02

    Recruiters

    They manage hiring pipelines and candidate details via chat.

  • 03

    Department Heads

    They monitor team structures and organizational metadata.

FAQ

Questions Freshteam owners ask.

  • 01

    How do I connect my Freshteam account?

    You subscribe through Vinkius and then enter your Freshteam Domain prefix and API Key from your Profile Settings.

  • 02

    Which AI clients can I use with this MCP?

    You can use any MCP-compatible client, including Claude, Cursor, and Windsurf.

  • 03

    Can I create new employees using the AI?

    Yes, you can use the create_employee_record capability to add new staff to your directory through your agent.

  • 04

    Does this MCP work with my existing Freshteam data?

    Yes, it connects directly to your Freshteam account to pull real-time employee, job, and leave data.

  • 05

    Is my HR data secure?

    Vinkius hosts the MCP and manages your credentials to ensure a secure connection to your Freshteam instance.

  • 06

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

  • 07

    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').

  • 08

    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.

  • 09

    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.

Explore

More in Human Resources

Suggestions

Connect Freshteam to Claude, Cursor, ChatGPT & more