Skip to main content

Connect HoorayHR to an AI assistant (MCP)

With MCP (Model Context Protocol), you connect HoorayHR to an AI assistant such as Claude, ChatGPT or Cursor. MCP is an open standard that lets an AI assistant retrieve data from external systems. After connecting, you can ask your AI assistant questions about the data in HoorayHR in plain language, without having to dig through reports yourself.

​

Heads up: connecting HoorayHR to an AI assistant via MCP is a feature in our Plus package.

What you can do with the connection

Once HoorayHR connects to your AI assistant, you can ask questions like:

  • How many leave hours does my team still have left this year?

  • Who is absent next week?

  • Which employments end within three months?

  • Give me an overview of sick leave in the past quarter.

The AI assistant retrieves the data live from HoorayHR at the moment you ask the question.

​

Set up the connection

You set up the connection from your AI assistant, not from HoorayHR. Each assistant does this slightly differently, but the steps usually come down to this:

  1. Open your AI assistant’s settings and look for the option to add a connector, integration or MCP server.

  2. Enter this URL: https://api.hoorayhr.io/mcp

  3. Log in with your HoorayHR account and give permission for the connection.

  4. When connecting, choose whether you give the assistant read-only permissions or write permissions too.

The connection is now active. From this point on, you can ask questions about HoorayHR in your AI assistant.

​

Tip: Stuck? Ask your AI assistant itself. It usually knows exactly where to add an MCP server in that app and helps you through the steps.

​

Heads up: You can’t use write permissions yet. The connection can retrieve data from HoorayHR, but it can’t change or create anything there yet.

​

Access for employees

As an admin, you decide whether your employees can also connect HoorayHR to an AI assistant. You set this up via Company settings > Visibility. If the setting is off, only admins can use this functionality.

​

​

Tip: Everyone only sees the data via the connection that they would also see in HoorayHR itself. So the user rights of an employee or team lead apply exactly as they do when logging in: a team lead sees their own team members, and an employee sees their own data.

​

Security and privacy

The connection works based on your own HoorayHR account, so it never shares more data than you’re allowed to see. If you want to disconnect it again, you do that in your AI assistant by removing the connector.

​

Keep in mind that the data you request goes to the provider of your AI assistant. So handle employee data carefully and check whether using that assistant fits the agreements in your organisation.

Related keywords: MCP, Model Context Protocol, connect AI assistant, Claude, ChatGPT, Cursor, AI connection, connector, read permissions, write permissions, visibility, Plus.

Did this answer your question?