How to Use the HiBob MCP in CrewAI

Q: How can a CrewAI team use the HiBob MCP server to manage onboarding?

You can create a 'Recruiter' agent that uses inviteemployee. Then, a 'Manager' agent could use listopentasks to track the new hire's progress, creating a sequential workflow.

Q: Can I limit which HiBob tools a specific CrewAI agent can use?

Yes. When you configure the MCPServerHTTP tool in CrewAI, you can use the toolfilter argument. This lets you expose only certain tools, like getleavebalance, to one agent while giving another agent access to requesttimeoff.

Q: Can one agent find an employee and another agent act on that information?

Exactly. An 'Analyst' agent can use searchemployees to find a specific person's profile. It then passes that employee's ID to a 'Coordinator' agent in the shared context, which can then use a tool like getleavebalance.

Deploy autonomous HR agent crews on the HiBob MCP Server. Use CrewAI to delegate tasks like directory updates, leave monitoring, and onboarding.

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 CrewAI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

A Crew for Proactive HR Operations

Assign a 'Monitor' agent to periodically run `list_open_tasks` and `get_whos_out`. This agent keeps an eye on pending items and employee availability without any human input. When the Monitor agent finds a new open task, it can delegate it to a 'Worker' agent. That agent can then use other tools, like `search_employees` to find the relevant person, and pass the context on for action.

Delegate Onboarding to a Specialist Crew

Build a multi-agent system for onboarding. An 'HR Admin' agent can use the `invite_employee` tool to send the welcome email. Then, a 'Compliance' agent can take over, using `list_open_tasks` to ensure the new hire completes all required paperwork. This division of labor is what CrewAI is built for, and this MCP server provides the necessary tools.

Keep Your Employee Directory Clean with CrewAI

Task a 'Directory Manager' agent to maintain your employee records. It can periodically use `list_public_profiles` to scan for inconsistencies or missing information. If the agent finds an issue, it can create a task for a human to review. It can also be configured to use `search_employees` with specific filters to identify profiles that need updating, like those with an old title.

Setup guide

Set up HiBob MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke HiBob tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="HiBob Analyst",
    goal="Access and analyze HiBob data via MCP.",
    backstory="Expert analyst with direct HiBob access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent HiBob transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="HiBob Analyst",
        goal="Access and analyze HiBob data via MCP.",
        backstory="Expert analyst with direct HiBob access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent HiBob transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

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 CrewAI

You can create a 'Recruiter' agent that uses `invite_employee`. Then, a 'Manager' agent could use `list_open_tasks` to track the new hire's progress, creating a sequential workflow.

Yes. When you configure the `MCPServerHTTP` tool in CrewAI, you can use the `tool_filter` argument. This lets you expose only certain tools, like `get_leave_balance`, to one agent while giving another agent access to `request_time_off`.

The simplest method is to pass your Vinkius server URL directly into the `mcps` list when defining your Agent. CrewAI handles the rest, making all 11 HiBob tools available to that agent.

Exactly. An 'Analyst' agent can use `search_employees` to find a specific person's profile. It then passes that employee's ID to a 'Coordinator' agent in the shared context, which can then use a tool like `get_leave_balance`.

Access is controlled by your Vinkius token. All tool calls, including `get_employee_compensation` and `get_payroll_history`, pass through a dedicated V8 Isolate sandbox for your session. This isolates the operation and ensures HiBob data is only accessible to your authenticated crew.

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