How to Use the HiBob MCP in Claude Code

Q: How do I add the HiBob MCP Server to Claude Code?

Run the command claude mcp add --transport http hibob -- in your terminal. This registers the server in your /.claude.json configuration, making all HR tools instantly available to your CLI agent.

Q: How do I check time-off balances using HiBob and Claude Code?

Just ask the CLI agent to check a balance. It will execute getleavebalance for the specified employee and output the exact remaining days right in your terminal window.

Pipe live HiBob HR data into terminal scripts and CI/CD workflows using Claude Code.

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 Claude Code

Create your Vinkius account to connect HiBob to Claude Code 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 Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run headless HR workflows from the terminal

This MCP Server turns your command line into an HR command center. SREs and DevOps engineers can run quick checks on team availability using `get_whos_out` or search the active directory via `search_employees` without launching a browser. Because Claude Code operates entirely in the shell, you can pipe the output of these tools into grep, awk, or local config files. It makes directory management as fast as querying a local database.

Automate CI/CD access using the directory

Keep your infrastructure access synchronized with your actual team roster. You can set up scripts that run `list_public_profiles` to verify who is currently active in the company before provisioning SSH keys or cloud console permissions. When an employee departs, your automated terminal agent can identify the change, run `list_open_tasks` to trigger an offboarding checklist, and ensure security policies are met. The server updates the ticket automatically.

Script automated onboarding invites via CLI

Standardize how you add new engineers to your systems. Use Claude Code to execute `invite_employee` and pass configuration parameters retrieved from `list_company_settings_lists` directly from a single terminal command. This eliminates manual data entry errors when setting up accounts. The agent handles the API calls in the background, letting you focus on terminal-based server setup and system configuration.

Setup guide

Set up HiBob MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see hibob-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest HiBob transactions." It will automatically discover and invoke the available HiBob tools.

Terminal

claude mcp add --transport http hibob-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "hibob-mcp": {
      "type": "url",
      "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 Claude Code

Run the command `claude mcp add --transport http hibob -- ` in your terminal. This registers the server in your `~/.claude.json` configuration, making all HR tools instantly available to your CLI agent.

Absolutely. You can tell the agent to fetch active users using `list_public_profiles` and pipe that text directly into local files or shell scripts to automate team roster updates.

Just ask the CLI agent to check a balance. It will execute `get_leave_balance` for the specified employee and output the exact remaining days right in your terminal window.

You can list all active company tasks by telling the agent to run `list_open_tasks`. When you finish a terminal-based onboarding task, tell the agent to run `complete_task` to update the system.

All terminal commands and tool executions run through a secure, single-token endpoint. Your employee profiles and leave balances are never cached externally, ensuring strict compliance with your company's data privacy policies.

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