HiBob MCP Server

🚧

The HiBob MCP server was release on April 28 and can currently be used only with a Bob service user. Access is limited to the permissions assigned to that service user. Employee-level access (with OAuth) is not supported at the moment.

Overview

The HiBob MCP server lets AI assistants and other MCP-compatible clients securely connect to Bob to retrieve information and perform actions in your HiBob account.

Access is authenticated with a Bob service user, and everything the assistant can see or do is limited to the permissions assigned to that service user.

Prerequisites

• An MCP client that supports connecting to a remote server via URL
• Access to the hosted server URL: https://api.hibob.com/ai-mcp-public/mcp/public
• Permissions-based access: The assistant can only access and act on the data that the Bob service user is allowed to access. See API service users.

Connecting to the hosted MCP server

To connect you need to provide the following details to your AI agent:

👍

Tip: You can use the Try it! option in the developer docs endpoints generate the encoded header. See use the Try it! option.

When connected successfully, you'll see the MCP server running and available in the agent UI.

Setup examples

Replace YOUR_ENCODED_TOKEN in the following examples with the encoded authorization token.

"mcpServers": {
    "hibob": {
      "type": "http",
      "url": "https://api.hibob.com/ai-mcp-public/mcp/public",
      "headers": {
        "Authorization": "Basic <YOUR_ENCODED_TOKEN>"
      }
    }
  }
}

"mcpServers": {
    "hibob": {
      "type": "http",
      "url": "https://api.hibob.com/ai-mcp-public/mcp/public",
      "headers": {
        "Authorization": "Basic <YOUR_ENCODED_TOKEN>"
      }
    }
  }
}

"mcpServers": {
    "hibob": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.hibob.com/ai-mcp-public/mcp/public",
        "--header", "Authorization: Basic <YOUR_ENCODED_TOKEN>"
      ]
    }
  }

"hibob-mcp-server-demo": {
    "url": "https://api.hibob.com/ai-mcp-public/mcp/public",
    "type": "http",
    "headers": {
    	"Authorization": "Basic <YOUR_ENCODED_TOKEN>"
     }
   }

Supported agents

The hosted MCP server supports any agent/client that can connect to an MCP server over URL

Available tools

Tools are grouped by domain, and their names include a prefix that indicates the module.

Capabilities:

• People: find employees, see profile fields (e.g., email, start date, birthday if permitted), create/update employee records (admin/service-user dependent).
• Time off: see who’s out, check balances, submit time-off requests.
• Tasks: view an employee’s tasks.

👍

Tip: To view the most up-to-date list of supported tools and their parameters, use tools/list in your MCP client.

What you can do with the MCP server

Employee data

Use natural language to find employees and retrieve employee fields that you have permission to view. You can also create or update employee records.

Example prompts:

• "What’s the birthday date for Emma Simmons?"
• "Find all employees in the R&D department in London and show name, email, and start date."
• "What employee fields can I read and update?"

Time off

Use natural language to check who’s out, check balances, and submit time off requests (if permitted).

Example prompts:

• "Who’s out today?"
• "What’s my time off balance for Holiday as of 2026-04-01?"
• "Submit vacation time off for 2026-04-12 to 2026-04-16."

Tasks

Use natural language to retrieve tasks for an employee (for example, open tasks).

Example prompts:

• "Show open tasks for Emma Simmons."

Troubleshooting

Authentication fails:

1. Verify the service user token is valid and correctly formatted for Basic auth. See Build your authorization header.
2. Confirm the user/service user has the required permissions in Bob to perform the actions you are trying to perform.
   • Required permissions for employee data
   • Required permissions for time off data
   • Required permissions for tasks data
3. Remove the integration in your MCP client and add it back to reauthenticate

Connection issues:

1. Verify the server URL is exactly https://api.hibob.com/ai-mcp-public/mcp/public
2. Confirm your MCP client supports connecting to remote servers via URL