How to Use the HiBob MCP in Windsurf

Get Cascade to handle your onboarding queues and time-off requests autonomously inside Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HiBob MCP to Windsurf

Create your Vinkius account to connect HiBob to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup HiBob with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate new hire setup in Windsurf

Cascade can handle the entire onboarding sequence without you babysitting it. When you tell it a new hire is starting, the agent triggers `invite_employee` to get them into the system, checks `list_company_settings_lists` to assign the right office location, and queues up their initial setup tasks. You don't have to prompt every single step of the process. The agent inspects the organizational structure, figures out what is missing, and updates the directory to keep your team records accurate from day one.

Run smart leave-balance checks

When teammates ask about vacation time, Cascade checks their status instantly. The agent calls `get_leave_balance` to pull the exact accrual numbers and compares it with `get_whos_out` to ensure there are no scheduling conflicts during the requested dates. If everything looks clear, Cascade prepares the JSON payload for `request_time_off` and queues it up for approval. You get a complete, ready-to-go plan without manually cross-referencing calendars or policy docs.

Resolve pending HR tasks inside your IDE

Don't let admin work pile up while you're trying to write actual code. This MCP Server lets your agent pull the active queue using `list_open_tasks` and match those items against real-time project milestones. Once Cascade verifies that a developer finished their setup or submitted their forms, it runs `complete_task` to close the loop. You manage your team's administrative requirements without ever leaving your active workspace.

Setup guide

Set up HiBob MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the HiBob MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my HiBob payment history." If connected, Cascade will call the HiBob tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "hibob-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by HiBob. 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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect HiBob now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about HiBob MCP in Windsurf

Open your Settings, navigate to Cascade, and find the MCP Servers UI to add the server configuration. You can also manually edit your `~/codeium/windsurf/mcp_config.json` file to register the connection. Once added, Cascade automatically discovers the tools and lets you query directory data.

Yes, that is exactly how Cascade is built. If you ask it to schedule time off, it will run `get_leave_balance` first, check for schedule conflicts using `get_whos_out`, and then execute `request_time_off` with the correct JSON payload.

Just ask Cascade to find a teammate or view a team list. The agent will run `search_employees` or `list_public_profiles` to fetch the contact details and display them directly in your chat panel.

The agent constructs the raw JSON payload with the required policyType, startDate, and endDate. It then feeds this structured data directly into the `request_time_off` tool to register the booking.

Your sensitive financial data remains inside a secure V8 sandbox. This configuration never exposes your raw API keys or database records, ensuring that tools like `get_employee_compensation` and `get_payroll_history` only run when explicitly authorized by your local session.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript