Loxo MCP Server

by tbensonwest

382 downloads

Not rated

GitHub

About

Enables interaction with the Loxo recruitment platform API, facilitating tasks such as candidate and job management, activity logging, and call queue management through AI assistants.

Details

Author: tbensonwest
Repository: tbensonwest/loxo-mcp-server
Downloads: 382
License: MIT License
Categories: AI, Workplace, Other

Setting up with Highlight

Follow these steps to add this server as a custom Highlight plugin:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Loxo MCP Server

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /path/to/loxo-mcp-server/build/index.js
Environment
- LOXO_DOMAIN app.loxo.co
- LOXO_API_KEY your_api_key
- LOXO_AGENCY_SLUG your_agency_slug
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Install Dependencies

npm install

Clone The Repository

git clone [repository-url]
cd loxo-mcp-server

Running The Server

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 \

  loxo-mcp-server

Option 0 Install Via Smithery Easiest

Install automatically for Claude Desktop via Smithery:

npx -y @smithery/cli install loxo-mcp-server --client claude

Option 1 Local Installation

Option 2 Docker Installation

bash

Docker Configuration

When using Docker, environment variables are automatically loaded from your .env file via Docker Compose, or can be passed directly:

Using Docker Compose (recommended):

Ensure Your Env File Is Configured

docker-compose up

Using 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

Note: The -i flag is required because MCP servers communicate over stdin/stdout.

`loxo_search_candidates`

Search the candidate database using Lucene queries. Filter by current title, past employers, skills, tags, location, or any combination. Returns 100 results per page including skillsets and tags.

`loxo_get_candidate`

Retrieve a full candidate profile including bio, current role, skills, tags, compensation, and the recruiter's intake and call notes.

`loxo_get_candidate_brief`

Get full candidate context, including profile, contact details, and recent activities in a single call. Supports pagination via scroll_id.

`loxo_get_person_emails`

Retrieve all email addresses on file for a candidate, with type labels (work, personal, etc.).

`loxo_get_person_phones`

Retrieve all phone numbers on file for a candidate, with type labels (mobile, work, home, etc.).

`loxo_list_person_job_profiles`

Get a complete work history list for a candidate including all roles, companies, and dates.

`loxo_get_person_job_profile_detail`

Get detailed information about a specific role in a candidate's work history.

`loxo_list_person_education_profiles`

Retrieve complete education history for a candidate including all degrees, schools, and dates.

`loxo_get_person_education_profile_detail`

Get detailed information about a specific education entry.

`loxo_search_jobs`

Search open roles using Lucene queries (title, location, or any combination).

`loxo_get_job`

Retrieve full job details including description, requirements, compensation, status, and hiring team.

`loxo_get_job_pipeline`

Get all candidates currently on a job with their pipeline stage and IDs.

`loxo_add_to_pipeline`

Add a candidate to a job's pipeline at the first stage.

`loxo_list_deal_workflows`

List all deal workflows (pipelines) with IDs and names.

`loxo_get_deal_workflow`

Get details of a deal workflow including pipeline stages.

`loxo_search_deals`

Search deals with optional Lucene query and owner email filter.

`loxo_get_deal`

Retrieve full deal details including name, amount, close date, pipeline stage, and linked company/person/job.

`loxo_create_deal`

Create a new deal in a pipeline. Requires name, amount, close date, workflow ID, and pipeline stage ID.

`loxo_log_deal_activity`

Log an activity on a deal.

`loxo_get_candidate_activities`

Get a full activity timeline for a candidate including all calls, emails, meetings, notes, and more.

`loxo_log_activity`

Record a completed activity against a candidate.

`loxo_schedule_activity`

Create a future activity for a candidate.

`loxo_get_todays_tasks`

Retrieve all scheduled items for today (or a specified date range).

`loxo_get_activity_types`

List all activity types and their IDs.

`loxo_create_company`

Create a new company (client/target account) with the required name.

`loxo_search_companies`

Search the company database using Lucene queries.

`loxo_get_company_details`

Retrieve a full company profile including description, contacts, relationships, and status.

`loxo_list_users`

List all users in your Loxo agency (recruiters, coordinators, etc.) with names and emails.

`loxo_list_skillsets`

List all Skillset and Sector Experience options with their IDs.

`loxo_list_source_types`

List all candidate source types with their IDs.

`loxo_list_person_types`

List all person type categories with their IDs.

`loxo_create_candidate`

Create a new candidate record with name, contact info, and current role.

`loxo_update_candidate`

Update an existing candidate's details.

`loxo_upload_resume`

Upload a CV or resume file to a candidate's profile, accepting base64-encoded file content.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

Loxo MCP Server

📚 Documentation: https://tbensonwest.github.io/loxo-mcp-server/

A Model Context Protocol (MCP) server that gives Claude direct access to the Loxo recruitment platform. Version 1.7.0 provides 34 tools covering the full recruiter workflow: searching and researching candidates, managing job pipelines, tracking activity and communication, working with companies, and maintaining candidate records. Tool descriptions guide Claude to surface recruiter intake notes and intel-rich activity history — so it can answer "where did we leave things with this candidate?" without you having to dig.

Installation

Option 0: Install via Smithery (easiest)

Install automatically for Claude Desktop via Smithery:

npx -y @smithery/cli install loxo-mcp-server --client claude

Option 1: Local Installation

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Install Dependencies

Clone The Repository

Running The Server

Option 0 Install Via Smithery Easiest

Option 1 Local Installation

Option 2 Docker Installation

Docker Configuration

Ensure Your Env File Is Configured

loxo_search_candidates

loxo_get_candidate

loxo_get_candidate_brief

loxo_get_person_emails

loxo_get_person_phones

loxo_list_person_job_profiles

loxo_get_person_job_profile_detail

loxo_list_person_education_profiles

loxo_get_person_education_profile_detail

loxo_search_jobs

loxo_get_job

loxo_get_job_pipeline

loxo_add_to_pipeline

loxo_list_deal_workflows

loxo_get_deal_workflow

loxo_search_deals

loxo_get_deal

loxo_create_deal

loxo_log_deal_activity

loxo_get_candidate_activities

loxo_log_activity

loxo_schedule_activity

loxo_get_todays_tasks

loxo_get_activity_types

loxo_create_company

loxo_search_companies

loxo_get_company_details

loxo_list_users

loxo_list_skillsets

loxo_list_source_types

loxo_list_person_types

loxo_create_candidate

loxo_update_candidate

loxo_upload_resume

Claude Desktop / Cursor

Linux

Macos

Windows

Loxo MCP Server

Installation

Option 0: Install via Smithery (easiest)

Option 1: Local Installation

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Context 7

Reactive Resume

`loxo_search_candidates`

`loxo_get_candidate`

`loxo_get_candidate_brief`

`loxo_get_person_emails`

`loxo_get_person_phones`

`loxo_list_person_job_profiles`

`loxo_get_person_job_profile_detail`

`loxo_list_person_education_profiles`

`loxo_get_person_education_profile_detail`

`loxo_search_jobs`

`loxo_get_job`

`loxo_get_job_pipeline`

`loxo_add_to_pipeline`

`loxo_list_deal_workflows`

`loxo_get_deal_workflow`

`loxo_search_deals`

`loxo_get_deal`

`loxo_create_deal`

`loxo_log_deal_activity`

`loxo_get_candidate_activities`

`loxo_log_activity`

`loxo_schedule_activity`

`loxo_get_todays_tasks`

`loxo_get_activity_types`

`loxo_create_company`

`loxo_search_companies`

`loxo_get_company_details`

`loxo_list_users`

`loxo_list_skillsets`

`loxo_list_source_types`

`loxo_list_person_types`

`loxo_create_candidate`

`loxo_update_candidate`

`loxo_upload_resume`