Loxo

You use this MCP server to empower AI assistants to interact with the Loxo recruitment platform API. It exposes tools for managing candidates, jobs, companies, and activities, enabling natural language workflows and automated recruiting tasks with reliable type safety and structured API calls.

How to use

You connect an MCP client to the server, then invoke tools through natural language prompts. Start by choosing a local or remote (Docker) server, then configure the client to talk to the MCP endpoint. Use the available tools to search candidates, retrieve full profiles, manage jobs and companies, and handle activities like scheduling or logging events.

How to install

# Option 1: Local Installation
# Clone the repository
git clone [repository-url]
cd loxo-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Option 2: Docker Installation
# Clone the repository
git clone [repository-url]
cd loxo-mcp-server

# Build the Docker image
docker build -t loxo-mcp-server .

# Or use Docker Compose
docker-compose build

Configuration

Configure access to the Loxo API by providing the required environment variables. Create a copy of the example environment file, then fill in your credentials.

LOXO_API_KEY=your_api_key
LOXO_DOMAIN=app.loxo.co
LOXO_AGENCY_SLUG=your_agency_slug

Runtime and running the server

Choose how you want to run the MCP server and ensure your client is configured to connect to it. The server can run locally with npm, or in Docker through Docker Compose or a direct container run.

# Locally
npm start

# With Docker Compose
docker-compose up

# With Docker directly
docker run -i \
  -e LOXO_API_KEY=your_api_key \
  -e LOXO_AGENCY_SLUG=your_agency_slug \
  -e LOXO_DOMAIN=app.loxo.co \
  loxo-mcp-server

MCP client integration with Claude Desktop

Configure Claude Desktop to load the Loxo MCP server. You can run a local server or a Docker container and reference it in Claude’s MCP configuration.

{
  "mcpServers": {
    "loxo": {
      "command": "node",
      "args": ["/path/to/loxo-mcp-server/build/index.js"],
      "env": {
        "LOXO_API_KEY": "your_api_key",
        "LOXO_AGENCY_SLUG": "your_agency_slug",
        "LOXO_DOMAIN": "app.loxo.co"
      }
    }
  }
}

MCP client integration with Docker

Alternatively, run the MCP server in Docker and reference it in Claude Desktop.

{
  "mcpServers": {
    "loxo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "LOXO_API_KEY=your_api_key",
        "-e", "LOXO_AGENCY_SLUG=your_agency_slug",
        "-e", "LOXO_DOMAIN=app.loxo.co",
        "loxo-mcp-server"
      ]
    }
  }
}

Available tools

get-activity-types

Retrieve the list of available activity types for scheduling or logging events.

get-todays-tasks

Fetch scheduled items for today, including tasks and activities.

schedule-activity

Create future activities linked to a person, job, or company with a selected activity type.

log-activity

Record a completed activity with notes for auditing and history.

search-candidates

Search candidates using complex Lucene-like queries; supports pagination and returns skillsets and tags.

get-candidate

Retrieve a full candidate profile with detailed history and attributes.

get-person-emails

Return all email addresses associated with a person.

get-person-phones

Return all phone numbers associated with a person.

list-person-job-profiles

List work history entries for a candidate.

get-person-job-profile-detail

Get detailed information for a specific job-entry in a candidate's history.

list-person-education-profiles

List education history for a candidate.

get-person-education-profile-detail

Get detailed information for a specific education entry.

search-jobs

Search job postings with filters; supports pagination.

get-job

Retrieve full details of a job posting.

search-companies

Search companies with filters; supports pagination.

get-company-details

Get a company profile with related contacts and relationships.

list-users

List agency users and contact information.