How do I use MCP Teamtailor?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Teamtailor list candidates created in the last week" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-teamtailor

The MCP Teamtailor is a Model Context Protocol (MCP) server that provides a simple integration with the teamtailor api.

Dependencies

No other dependencies are required to use the MCP Teamtailor server.

Related MCP server: Teams Messenger MCP App

Usage

MCP servers are configured differently depending on the client that you are using. For reference, this is how you would configure it using Claude Desktop.

{
  "mcpServers": {
    "teamtailor": {
      "command": "npx",
      "args": [
        "-y",
        "@crunchloop/mcp-teamtailor"
      ],
      "env": {
        "TEAMTAILOR_URL": "https://api.teamtailor.com/v1",
        "TEAMTAILOR_API_KEY": "XXXX"
      }
    }
  }
}

MCP Transport

At the moment, only stdio transport has been implemented.

Tools

teamtailor_list_candidates - List and filter candidates.
- pageSize: The size of the page response (string, optional)
- page: The page number to retrieve (string, optional)
- filter.createdAfter: Filter candidates created after a specific date (string, optional)
- filter.createdBefore: Filter candidates created before a specific date (string, optional)
- filter.updatedAfter: Filter candidates updated after a specific date (string, optional)
- filter.updatedBefore: Filter candidates updated before a specific date (string, optional)
teamtailor_get_candidate - Get a single candidate by their id.
- candidateId: The id of the candidate to retrieve (number, required)