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"
    }
  }
}

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.

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

Next steps