mcp-teamtailor
About
The MCP Teamtailor is a Model Context Protocol (MCP) server that provides a simple integration with the [teamtailor api](https://docs.teamtailor.com/).
Details
- License
- MIT
Explore
- List candidates with optional filters and pagination
- Get a single candidate by ID
- No additional dependencies required
- Lightweight, stdio-based transport
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- 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
mcp-teamtailorCommand (node, npx, python, etc.)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
From the repository
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"
}
}
}
}
teamtailor_list_candidates
List and filter candidates.
teamtailor_get_candidate
Get a single candidate by their id.
- 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)
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp-teamtailor": {
"teamtailor": {
"command": "npx",
"args": [
"-y",
"@crunchloop/mcp-teamtailor"
],
"env": {
"TEAMTAILOR_URL": "https://api.teamtailor.com/v1",
"TEAMTAILOR_API_KEY": "XXXX"
}
}
}
}
}McpServers
{
"teamtailor": {
"command": "npx",
"args": [
"-y",
"@crunchloop/mcp-teamtailor"
],
"env": {
"TEAMTAILOR_URL": "https://api.teamtailor.com/v1",
"TEAMTAILOR_API_KEY": "XXXX"
}
}
}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.
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)
License
Released under the MIT License. See the LICENSE file for further details.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
