CitoHRCitoHR
Integrations / Connect agents via MCP

Connect agents via MCP

Link MCP-compatible AI assistants to CitoHR so they can help with leave, people data, and other day-to-day HR work.

Overview

CitoHR exposes a Model Context Protocol (MCP) endpoint. Compatible AI assistants can connect to that URL and use CitoHR tools securely — useful for UK SMEs that want help with routine HR questions and tasks without building a custom integration.

Assistants people commonly use with MCP include Claude, ChatGPT, and Microsoft Copilot. Any product that supports remote MCP servers over HTTPS can use the same endpoint.

Production MCP endpoint: 

https://app.citohr.com/api/mcp

How to connect

Exact steps vary by assistant, but the flow is the same:

  1. Open the assistant’s settings for connectors, tools, or MCP servers.
  2. Add a new MCP server named citohr (or similar).
  3. Set the server URL to the production endpoint above.
  4. Save, then complete any sign-in or authorisation prompts so the assistant can access your CitoHR organisation.
  5. Confirm the CitoHR connection shows as available before you start asking HR questions.

Example server configuration

Many MCP clients accept a JSON server entry like this: 

{
  "mcpServers": {
    "citohr": {
      "url": "https://app.citohr.com/api/mcp"
    }
  }
}

What assistants can do

The CitoHR MCP connection supports both reading and writing. A connected assistant can:

  • Show your profile, your manager and the equipment issued to you.
  • Check your leave balance, list your leave requests, and submit a new leave request, including half days where your organisation allows them.
  • Show who is off on given dates, from the same leave calendar you see in CitoHR.
  • List your upcoming shifts and open shifts you could pick up, pick one up, or request a shift swap with a colleague.
  • List your expense claims and expense categories, and submit a new expense claim (receipts are added in CitoHR).
  • List your documents and unread documents, and mark a document as read.
  • Show your training records and unread notifications.
  • List the titles of your organisation’s active policies (not the policy files).
  • For managers and admins, list colleagues’ names and departments. Admins can also see headcount by department and pending leave across the organisation.

Changes made through an assistant follow the same rules as in CitoHR. A leave request is checked against your organisation’s leave settings, such as minimum notice and maximum consecutive days, created as pending, and sent to your approvers. Expense claims and shift swaps also go through their usual approval steps. Assistants cannot approve or reject requests.

Authentication

When you connect an assistant, follow any sign-in or authorisation prompts it shows so it can access your CitoHR organisation with the correct permissions.

You sign in with your CitoHR account, choose the organisation to connect, and choose what to allow on the consent screen. Reading your HR information is always included. Making changes for you, such as submitting leave requests and expense claims, is ticked by default, and you can untick it to keep the connection read-only. If you connected an assistant before write access was available, reconnect it to allow changes.

MCP is available on the Pro and Pro Plus plans, including during an active trial. It is not available on the Free plan.

For custom HTTP integrations that call the REST API directly (outside MCP), use the documented token flow in the API authentication guide.

Next steps