Skip to main content
Glama
@slantis/mcp-teamtailor

@slantis/mcp-teamtailor

by slantis

@slantis/mcp-teamtailor

Full-coverage, read-only MCP server for the Teamtailor recruitment API.

Exposes 18 tools covering the entire Teamtailor data model — candidates, jobs, applications, offers, stages, departments, locations, users, and activities — with strict input validation and safe error handling.

Read-only by design. This server makes no write calls. No candidates, jobs, or applications can be created, modified, or deleted through this MCP.


Installation

npm install -g @slantis/mcp-teamtailor
# or run directly with npx (no install needed):
npx @slantis/mcp-teamtailor

Related MCP server: Greenhouse MCP

Configuration

Add to your Claude Code (or Claude Desktop) MCP config:

{
  "mcpServers": {
    "teamtailor": {
      "command": "npx",
      "args": ["-y", "@slantis/mcp-teamtailor"],
      "env": {
        "TEAMTAILOR_API_KEY": "your-admin-api-key",
        "TEAMTAILOR_URL": "https://api.na.teamtailor.com/v1"
      }
    }
  }
}

Environment variables

Variable

Required

Default

Description

TEAMTAILOR_API_KEY

Yes

—

Admin API key from Teamtailor → Settings → API Keys

TEAMTAILOR_URL

No

https://api.teamtailor.com/v1

Base URL. Use https://api.na.teamtailor.com/v1 for North America

TEAMTAILOR_API_VERSION

No

20210218

Teamtailor API version date string


Tools Reference

Candidates

Tool

Description

list_candidates

List candidates with optional date filters and pagination

get_candidate

Get full candidate details by ID

Jobs

Tool

Description

list_jobs

List jobs — filter by status, department, or location

get_job

Get full job details by ID

Applications

Tool

Description

list_job_applications

List applications — filter by job, candidate, or stage

get_job_application

Get application details including current stage

Offers

Tool

Description

list_job_offers

List job offers — filter by application

get_job_offer

Get offer details including sent/accepted/rejected dates

Pipeline

Tool

Description

list_stages

List pipeline stages — filter by job

get_stage

Get stage details by ID

Structure

Tool

Description

list_departments

List all departments

get_department

Get department details by ID

list_locations

List all office locations

get_location

Get location details by ID

Users

Tool

Description

list_users

List all Teamtailor users (recruiters, hiring managers)

get_user

Get user details by ID

Audit

Tool

Description

list_activities

List activity log — filter by subject type and ID

get_activity

Get a specific activity entry by ID


Example prompts

  • "List the first 5 open jobs in Teamtailor"

  • "Find candidates who applied in the last 7 days"

  • "What stages does job 12345 have?"

  • "Show me all applications for job 42 that are still in the first stage"

  • "What's the activity history for candidate 99?"


Development

npm install
npm run dev          # run with tsx (no build needed)
npm run typecheck    # type-check without emitting
npm test             # run vitest
npm run build        # compile to dist/

License

MIT © Slantis

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      A Model Context Protocol server that enables integration with the Teamtailor API, allowing users to list, filter, and retrieve candidate information from their Teamtailor recruitment platform.
      2
      7 npm
      5
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Production-ready MCP server for Greenhouse ATS with 175 tools for recruiting teams — manage candidates, applications, jobs, interviews, and hiring pipelines. Role-based profiles (full/recruiter/read-only), composite workflow tools for pipeline views, analytics, candidate search, and bulk operations.
      187
      66 PyPI
      5
      MIT
    • A
      license
      B
      quality
      F
      maintenance
      Official Model Context Protocol server for 100Hires — the applicant tracking system for recruiting teams. Exposes the full 100Hires API v2 as 130 MCP tools, enabling AI assistants to manage candidates, jobs, applications, interviews, messages, and more.
      100
      8 npm
      1
      MIT